GET/api/v1/me/addresses列出我的收货地址

Try it 面板需要启用 JavaScript。

返回当前用户的全部收货地址。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

Response

Body

Name	Data Type	Required	Description
items	array	Yes	地址列表

type ResponseBody = {
  /** 地址列表 */
  items: Record<string, unknown>[]
}

{
  "items": [
    {
      "addressId": "01JD8SNQ7N9R2W8YR3V6YEL0W4F",
      "recipient": "陈林",
      "region": "上海市 浦东新区",
      "detail": "张江高科技园区博云路 2 号 501 室",
      "postcode": "201203",
      "isDefault": true,
      "createdAt": "2026-10-14T11:20:00Z",
      "updatedAt": "2026-10-14T11:20:00Z"
    }
  ]
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回地址列表

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	返回地址列表

Examples

GET /api/v1/me/addresses
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8SOGM5A7H4I",
  "code": 0,
  "messages": [],
  "result": {
    "items": [
      {
        "addressId": "01JD8SNQ7N9R2W8YR3V6YEL0W4F",
        "recipient": "陈林",
        "region": "上海市 浦东新区",
        "detail": "张江高科技园区博云路 2 号 501 室",
        "postcode": "201203",
        "isDefault": true,
        "createdAt": "2026-10-14T11:20:00Z",
        "updatedAt": "2026-10-14T11:20:00Z"
      }
    ]
  }
}