NATSprofile.address.list列出用户地址

Try it 面板需要启用 JavaScript。

返回用户全部收货地址。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	Yes	用户 ID

type RequestBody = {
  /** 用户 ID */
  userId: string
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C"
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

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

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

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

Response Code

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

code	Meaning	Notes
0	成功	列出用户地址

Examples

{ "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C" }

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