Appearance
编辑地址接口
概述
用于更新已有地址信息，由小程序前端调用。
接口信息
| 项目 | 内容 |
|---|---|
| 接口名称 | 编辑地址 |
| 接口用途 | 更新已有地址 |
| 调用方 | 小程序前端 |
| 请求方式 | PUT |
| 请求路径 | /addresses/{addressId} |
| 请求头要求 | Authorization、X-Idempotency-Key |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
addressId | path string | 是 | 地址 ID |
consignee | string | 是 | 收货人 |
mobile | string | 是 | 手机号 |
province | string | 是 | 省 |
city | string | 是 | 市 |
district | string | 是 | 区 |
detailAddress | string | 是 | 详细地址 |
isDefault | bool | 否 | 是否默认 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
success | bool | 修改结果 |
成功响应示例
{"code":"0","message":"ok","data":{"success":true}}
失败响应示例
错误码
| 错误码 | 说明 |
|---|---|
A0001 | 见业务定义 |
A0002 | 无权限修改该地址 |
A0003 | 见业务定义 |
接口约束
| 项目 | 说明 |
|---|---|
| 幂等要求 | 是 |
| 前后端同步规则 | 更新成功后刷新列表 |
| 缓存/刷新策略 | 不缓存 |
| 一致性要求 | 强一致 |
实现要点
- 请求必须携带
Authorization与X-Idempotency-Key请求头。 addressId通过路径参数传递。- 更新成功后，前端应立即刷新地址列表以保证数据同步。
- 接口不做缓存，要求强一致性返回最新结果。