POST/api/v1/me/addresses新增一个收货地址

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

Body

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

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

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

POST /api/v1/me/addresses
Authorization: Bearer st_7c1f9e05b28d4a63
Content-Type: application/json

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

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

Remarks

设为默认地址会将原默认地址置为非默认；每个用户至多一个默认地址。