Appearance
新增地址接口
基本信息
- 接口名称：新增地址
- 接口用途：新增收货地址
- 调用方：小程序前端
- 请求方式：
POST - 请求路径：
/addresses - 请求头要求：
Authorization、X-Idempotency-Key
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| consignee | string | 是 | 收货人 |
| mobile | string | 是 | 手机号 |
| province | string | 是 | 省 |
| city | string | 是 | 市 |
| district | string | 是 | 区 |
| detailAddress | string | 是 | 详细地址 |
| isDefault | bool | 否 | 是否默认 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| addressId | string | 地址 ID |
成功响应示例
{"code":"0","message":"ok","data":{"addressId":"ad_2"}}
失败响应示例
错误码
A0001A0003
接口约束
- 幂等要求：是
- 缓存策略：不缓存
- 一致性要求：强一致性
前后端同步规则
- 保存成功后刷新地址列表
- 刷新完成后回传选择结果