V1/user/add my address
来自技术开发小组内部wiki
目录
功能说明
添加或修改用户收货地址 本接口是全平台通用的,即发送请求后,可根据请求中传入的平台参数返回发送状态。
URL
正式环境 http://api.fumubang.com/v1/user/add_my_address 测试环境 http://api.fumubang.net/v1/user/add_my_address
格式
json
HTTP请求方式
POST
输入参数说明
uid = xxxxxxxx 用户UID
province_id = xxxxxxxx 省/市ID
city_id = xxxxxxxxx 市/区ID
mobile = xxxxxx 收货人手机号
address = xxxxxx 收货人详细地址
zipcode = xxxxxx 邮编
receiver = xxxxxx 收货人姓名
is_default = 1 是否设置为默认地址(1是,0否)
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
uid | 是 | int | 以json格式POST传入,用户UID |
mobile | 是 | string | 以json格式POST传入,收货人的手机号 |
province_id | 是 | int | 以json格式POST传入,省市ID |
city_id |
是 | int | 以json格式POST传入,市/区ID |
area |
是 |
int |
地区ID(3.20版本新增) |
address | 是 | string | 以json格式POST传入,收货详细地址 |
zipcode | 是 | string | 以json格式POST传入,收货人邮编 |
receiver | 是 | string | 以json格式POST传入,收货人姓名 |
is_default | 是 | int | 以json格式POST传入, 是否设置为默认地址(1是,0否) |
address_id |
是 |
int |
地址id,更改是必传。默认添加不传 |
请求示例
http://api.fumubang.com/v1/user/add_my_address
openid=xxxxxxx 父母邦分配
openkey=xxxxxxxx 父母邦分配 uid = xxxxxxxx 用户UID
province_id = xxxxxxxx 省/市ID
city_id = xxxxxxxxx 市/区ID
mobile = xxxxxx 收货人手机号
address = xxxxxx 收货人详细地址
zipcode = xxxxxx 邮编
receiver = xxxxxx 收货人姓名
is_default = 1 是否设置为默认地址(1是,0否)
参数用POST方式提交
返回方式说明
xml或json
正确返回说明
<status>success</status>成功返回状态
错误返回示例
参数不全
<error_code>300000</error_code> <error_msg>参数不全</error_msg>
地址添加失败
<error_code>300001</error_code> <error_msg>地址添加失败</error_msg>
手机号码格式不正确
<error_code>300002</error_code> <error_msg>手机号码格式不正确</error_msg>
邮编格式不正确
<error_code>300003</error_code> <error_msg>邮编格式不正确</error_msg>