优化首页和收货地址管理

docs/PlayX-接口文档.md

@@ -447,6 +447,43 @@ curl -X POST 'http://localhost:1818/api/v1/playx/verify-token' \
   --data-urlencode 'token=上一步TemLogin返回的token'
 ```
 
+---
+
+### 3.x 收货地址（`mall_address`）
+
+> 下面接口用于 H5 维护收货地址。鉴权同本章其他接口：携带 `session_id` 或 `token` 或 `user_id`。
+
+#### 3.x.1 地址列表
+* 方法：`GET`
+* 路径：`/api/v1/playx/address/list`
+
+返回：`data.list` 为地址数组。
+
+#### 3.x.2 添加地址
+* 方法：`POST`
+* 路径：`/api/v1/playx/address/add`
+
+Body：
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `phone` | 是 | 电话 |
+| `region` | 是 | 地区（数组或逗号分隔字符串） |
+| `detail_address` | 是 | 详细地址 |
+| `address` | 是 | 地址补充 |
+| `default_setting` | 否 | `1` 设为默认地址 |
+
+#### 3.x.3 修改地址（含设为默认）
+* 方法：`POST`
+* 路径：`/api/v1/playx/address/edit`
+
+Body：`id` 必填，其余字段按需传入更新。
+
+#### 3.x.4 删除地址
+* 方法：`POST`
+* 路径：`/api/v1/playx/address/delete`
+
+Body：`id` 必填。若删除默认地址，服务端会自动挑选一条剩余地址设为默认（如存在）。
+
 #### 远程模式（`verify_token_local_only=false` + 已配置 `base_url`）
 
 商城侧请求 URL：`${playx.api.base_url}${playx.api.token_verify_url}`（默认路径 `/api/v1/auth/verify-token`）。