顾客-收货地址列表

Customer Get Address List API 文档

接口信息

接口地址: {your-site-url}/api/skill/customer/get-address-list
基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
请求方式: GET
说明: 此接口用于获取指定客户的所有收货地址列表

认证

请求头中需要携带 skill-access-token：

Header	值
`skill-access-token`	`{your-skill-access-token}` （请替换为你自己的 token）

请求参数 (Query String)

字段	类型	必填	说明
`customer_id`	int	✅ 必填	客户 ID

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/customer/get-address-list?customer_id=558' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": [
        {
            "id": 2444,
            "shop_id": 15,
            "customer_id": 558,
            "address_1": "115 Gaze Road",
            "address_2": "321329111543543",
            "city": "Christmas Island",
            "country_code": "CX",
            "company": "",
            "first_name": "Terry",
            "last_name": "zhao",
            "email": "fecify@126.com",
            "province_code": "JX",
            "zip": "6798",
            "phone": "+1 18622221111",
            "is_default": 2,
            "created_at": "2026-05-21 14:38:35",
            "updated_at": "2026-05-21 14:38:35",
            "country": {
                "code": "CX",
                "cn_name": "圣诞岛",
                "name": "Christmas Island"
            },
            "province": {
                "code": "JX",
                "country_code": "CN",
                "name": "Jiangxi"
            }
        }
    ],
    "message": "success"
}

返回字段说明

字段	类型	说明
`code`	Number	状态码，`200` 表示成功
`message`	String	执行结果的文字描述
`data`	Array[Object]	地址列表

data 子项字段

字段	类型	说明
`id`	int	地址 ID
`shop_id`	int	店铺 ID
`customer_id`	int	客户 ID
`address_1`	string	详细地址 1
`address_2`	string	详细地址 2
`city`	string	城市
`country_code`	string	国家代码
`company`	string	公司名称
`first_name`	string	名
`last_name`	string	姓
`email`	string	邮箱
`province_code`	string	省份代码
`zip`	string	邮政编码
`phone`	string	电话号码
`is_default`	int	是否为默认地址。`1` = 默认地址，`2` = 非默认
`created_at`	string	创建时间
`updated_at`	string	更新时间
`country`	Object	国家信息对象
`province`	Object/null	省份信息对象。`null` 表示无省份数据

country 子字段

字段	类型	说明
`code`	string	国家代码
`cn_name`	string	国家中文名称
`name`	string	国家英文名称

province 子字段

字段	类型	说明
`code`	string	省份代码
`country_code`	string	所属国家代码
`name`	string	省份名称

注意事项

customer_id 为必填参数
每个客户可能有多个地址，is_default 为 1 的是默认地址
province 可能为 null，取决于该国家是否有省份数据

results matching ""

No results matching ""