PATCH/api/v1/me/addresses/:addressId更新一个收货地址

Try it 面板需要启用 JavaScript。

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

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`
Content-Type	string	Yes	请求体内容类型（默认值 "application/json"）

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
  /** 请求体内容类型，默认值 "application/json" */
  Content-Type: string
}

{
  "Authorization": "Bearer st_7c1f9e05b28d4a63",
  "Content-Type": "application/json"
}

URL Parameters

Name	Data Type	Description
addressId	string	地址 ID

Body

Name	Data Type	Required	Description
recipient	string	No	收件人姓名
region	string	No	地区描述
detail	string	No	详细地址
postcode	string	No	邮政编码
isDefault	boolean	No	是否设为默认地址

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

{
  "detail": "张江高科技园区博云路 2 号 602 室",
  "isDefault": true
}

Response

Body

AddressDTO

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 AddressDTO = {
  /** 地址 ID */
  addressId: string
  /** 收件人姓名 */
  recipient: string
  /** 省 / 州、城市等地区描述 */
  region: string
  /** 详细地址 */
  detail: string
  /** 邮政编码 */
  postcode?: string
  /** 是否默认地址 */
  isDefault: boolean
  /** 创建时间 */
  createdAt: string
  /** 最近更新时间 */
  updatedAt: string
}

{
  "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

PATCH /api/v1/me/addresses/01JD8SNQ8N0S3W9ZS4W7ZFM1X4H
Authorization: Bearer st_7c1f9e05b28d4a63
Content-Type: application/json

{
  "detail": "张江高科技园区博云路 2 号 602 室",
  "isDefault": true
}

{
  "id": "01JD8SOIPC7C9K6",
  "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"
  }
}