更新地址

PUT 
/openapi/2026-07/customers/:customer_id/addresses/:address_id

通过地址 ID 更新现有地址的详细信息。

请求

Path参数

customer_id string必填

顾客 ID

address_id string必填

地址 ID

application/json

请求体

请求体必填

address object必填

地址

first_namestring

收件人的名

last_namestring

收件人的姓

emailstring

收件人的电子邮件地址，用于指定收件人的邮箱

address1string

地址，如门牌号和街道名称，用于指定地址的主要位置

address2string

附加地址，如公寓号或套房号，用于提供更具体的地址信息

areastring

地址所在区域或地区

citystring

地址所在城市，指定城市或乡镇的名称

provincestring

省份或州

province_codestring

省份代码

countrystring

国家名称

country_codestring

ISO 国家代码

companystring

与地址关联的公司名称

phonestring

收件人的电话号码

phone_area_codestring

电话区号

zipstring

邮政编码

genderstring

人员性别，可选字段。可接受值为 "male" 和 "female"

defaultboolean

是否为默认地址。若为用户创建的第一个地址则为 "true"，否则为 "false"

示例

{
  "address": {
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "address1": "string",
    "address2": "string",
    "area": "string",
    "city": "string",
    "province": "string",
    "province_code": "string",
    "country": "string",
    "country_code": "string",
    "company": "string",
    "phone": "string",
    "phone_area_code": "string",
    "zip": "string",
    "gender": "string",
    "default": true
  }
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

address object

地址

idstring

地址的唯一标识

customer_idstring

顾客 ID

first_namestring

收件人的名

last_namestring

收件人的姓

companystring

公司名称

citystring

地址所在城市

provincestring

地址所在省份或州

countrystring

地址所在国家名称

zipstring

邮政编码

province_codestring

省份代码

country_codestring

ISO 国家代码

genderstring

收件人的性别

phonestring

与地址关联的电话号码

phone_area_codestring

电话号码的区号

areastring

地址所在区域或地区

emailstring

与地址关联的电子邮件

namestring

收件人的全名

address1string

地址1

address2string

地址2

country_namestring

国家全称

defaultboolean

是否为默认地址

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "address": {
      "id": "string",
      "customer_id": "string",
      "first_name": "string",
      "last_name": "string",
      "company": "string",
      "city": "string",
      "province": "string",
      "country": "string",
      "zip": "string",
      "province_code": "string",
      "country_code": "string",
      "gender": "string",
      "phone": "string",
      "phone_area_code": "string",
      "area": "string",
      "email": "string",
      "name": "string",
      "address1": "string",
      "address2": "string",
      "country_name": "string",
      "default": true
    }
  }
}