Skip to main content
POST
/
orders
/
{id}
/
address
/
detail
Change Address Detail
curl --request POST \
  --url https://api.example.com/orders/{id}/address/detail \
  --header 'Content-Type: application/json' \
  --data '
{
  "detail": "<string>"
}
'
Updates the detailed address information for an order.

​
Path Parameters

​
id
string
required
The unique identifier of the order to modify.

​
Request Body

​
detail
string
required
The new detailed address information (e.g., street address, building number, apartment). Cannot be null.

​
Response

Returns no content on success.

​
Status Codes

  • 200 OK - Address detail updated successfully
  • 400 Bad Request - Invalid request body or validation errors
  • 404 Not Found - Order not found
  • 409 Conflict - Order cannot be modified

​
Error Responses

​
Order Not Found (404)

{
  "code": "ORDER_NOT_FOUND",
  "message": "没有找到订单",
  "orderId": "order_123"
}

​
Order Cannot Be Modified (409)

{
  "code": "ORDER_CANNOT_BE_MODIFIED",
  "message": "订单无法变更",
  "orderId": "order_123"
}
This error occurs when attempting to modify an order that has already been paid or shipped.

​
Validation Errors (400)

  • “详细地址不能为空” - Detail address cannot be null

​
Example Request

curl -X POST https://api.example.com/orders/order_abc123def456/address/detail \
  -H "Content-Type: application/json" \
  -d '{
    "detail": "789 Pine Street, Building A, Suite 1200"
  }'

​
Example Response

No content is returned on success (status 200).

Build docs developers (and LLMs) love

Get started for freeTalk to us