查询地址列表

GET 
/openapi/2025-06/customers/:customer_id/addresses

分页返回地址列表。

请求

Path参数

customer_id string必填

顾客 ID

Query参数

cursor string

分页游标

page_size int32

每页记录数

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

addresses object[]

地址列表

Array [

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

是否为默认地址

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "addresses": [
      {
        "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
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}