NATSprofile.address.update更新地址

Try it 面板需要启用 JavaScript。

更新指定地址；未提供的字段保持不变。

Request Payload

消息格式：JSON

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

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

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "addressId": "01JD8SNQ8N0S3W9ZS4W7ZFM1X4H",
  "detail": "张江高科技园区博云路 2 号 602 室"
}

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 号 602 室",
  "postcode": "201203",
  "isDefault": true,
  "createdAt": "2026-10-14T11:30:00Z",
  "updatedAt": "2026-10-14T11:45:00Z"
}

Response Code

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

code	Meaning	Notes
0	成功	更新地址

Examples

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "addressId": "01JD8SNQ8N0S3W9ZS4W7ZFM1X4H",
  "detail": "张江高科技园区博云路 2 号 602 室"
}

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