Table of Contents
7.23 新增收货地址【未授权拦截通过,待登录态联调】
POST /tieup/api/v1/me/addresses
请求体:
{
"receiver_name": "张三",
"receiver_phone": "13800000000",
"province_code": "310000",
"province_name": "上海市",
"city_code": "310100",
"city_name": "上海市",
"district_code": "310101",
"district_name": "黄浦区",
"detail_address": "详细地址",
"is_default": 1
}
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
receiver_name |
string | 是 | 收货地址联系人姓名 |
receiver_phone |
string | 是 | 收货地址联系人手机号 |
province_name |
string | 是 | 省份名称 |
city_name |
string | 是 | 城市名称 |
district_name |
string | 否 | 区县名称 |
detail_address |
string | 是 | 完整收货地址 |
is_default |
integer | 否 | 1=是,2=否 |
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
id |
integer | 主键 ID |
receiver_name |
string | 收货人姓名 |
receiver_phone |
string | 收货人手机号 |
province_name |
string | 省份名称 |
city_name |
string | 城市名称 |
district_name |
string | 区县名称 |
detail_address |
string | 详细地址 |
is_default |
integer | 是否默认地址:1=是,2=否 |
响应示例:
{
"code": 200,
"message": "成功",
"data": {
"id": 1,
"receiver_name": "张三",
"receiver_phone": "13800138000",
"province_name": "广东省",
"city_name": "深圳市",
"district_name": "南山区",
"detail_address": "科技园 1 号",
"is_default": 1
}
}
说明:设置 is_default = 1 时,服务端在事务内锁定当前用户并清理旧默认地址,避免并发下出现多个默认地址。