订单-收货地址-保存
订单 - 修改收货地址
接口信息
- 接口地址:
{your-site-url}/api/skill/order/change-shipping-address
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
- 请求方式:
POST
- 说明: 此接口用于修改指定订单的收货地址信息。
认证
请求头中需要携带 skill-access-token：
| Header |
值 |
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
Content-Type |
application/json |
请求参数 (JSON Body)
| 字段 |
类型 |
必填 |
说明 |
order_id |
int |
是 |
订单 ID |
shipping_address |
Object |
是 |
修改后的收货地址信息 |
shipping_address 字段
| 字段 |
类型 |
必填 |
说明 |
shipping_address.first_name |
string |
是 |
收货人名字 |
shipping_address.last_name |
string |
是 |
收货人姓氏 |
shipping_address.phone |
string |
是 |
收货人电话 |
shipping_address.email |
string |
是 |
收货人邮箱 |
shipping_address.country_code |
string |
是 |
国家简码，从 得到国家和省列表 获取 |
shipping_address.province_code |
string |
是 |
省/州简码 |
shipping_address.city |
string |
是 |
城市 |
shipping_address.address_1 |
string |
是 |
详细地址行 1 |
shipping_address.address_2 |
string |
是 |
详细地址行 2 |
shipping_address.company |
string |
否 |
公司名称 |
shipping_address.zip |
string |
是 |
邮政编码 |
shipping_address.order_id |
int |
是 |
所属订单 ID（与顶层的 order_id 一致） |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/order/change-shipping-address' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"order_id": 6416,
"shipping_address": {
"order_id": 6416,
"first_name": "张",
"last_name": "三",
"phone": "+358 13133333333",
"email": "11e867235711@qq.com",
"country_code": "CN",
"province_code": "AH",
"city": "青岛",
"address_1": "辽源路街道",
"address_2": "4-4-403",
"company": "",
"zip": "266300"
}
}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [],
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码，200 表示成功 |
message |
String |
执行结果的文字描述 |
data |
Array |
返回数据（修改成功时为空数组） |
操作流程
- 调用 订单-收货地址-获取 获取当前收货地址，同时通过返回的
isCanChangeAddress 判断是否允许修改
- 如
isCanChangeAddress 为 true，修改地址信息后调用本接口提交
注意事项
- 修改收货地址前，通过 订单-收货地址-获取 返回的
isCanChangeAddress 判断是否允许修改
country_code 和 province_code 需传入有效的简码值，对应 得到国家和省列表 中的国家/省简码shipping_address.order_id 需与顶层 order_id 保持一致