NATSprofile.address.create创建地址

Try it 面板需要启用 JavaScript。

新建收货地址；首条自动成为默认。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	Yes	用户 ID
recipient	string	Yes	收件人
region	string	Yes	地区
detail	string	Yes	详细地址
postcode	string	No	邮政编码
isDefault	boolean	No	是否设为默认

type RequestBody = {
  /** 用户 ID */
  userId: string
  /** 收件人 */
  recipient: string
  /** 地区 */
  region: string
  /** 详细地址 */
  detail: string
  /** 邮政编码 */
  postcode?: string
  /** 是否设为默认 */
  isDefault?: boolean
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "recipient": "陈林",
  "region": "上海市 浦东新区",
  "detail": "张江高科技园区博云路 2 号 501 室",
  "postcode": "201203",
  "isDefault": true
}

Response Payload

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

Name	Data Type	Required	Description
addressId	string	Yes	地址 ID
recipient	string	Yes	收件人
region	string	Yes	地区
detail	string	Yes	详细地址
postcode	string	No	邮政编码
isDefault	boolean	Yes	是否默认
createdAt	string	Yes	创建时间
updatedAt	string	Yes	更新时间

type ResponseBody = {
  /** 地址 ID */
  addressId: string
  /** 收件人 */
  recipient: string
  /** 地区 */
  region: string
  /** 详细地址 */
  detail: string
  /** 邮政编码 */
  postcode?: string
  /** 是否默认 */
  isDefault: boolean
  /** 创建时间 */
  createdAt: string
  /** 更新时间 */
  updatedAt: string
}

{
  "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",
  "recipient": "陈林",
  "region": "上海市 浦东新区",
  "detail": "张江高科技园区博云路 2 号 501 室",
  "postcode": "201203",
  "isDefault": true
}

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