客户地址

客户地址

客户地址资源表示存储客户已输入的地址。每个客户可以有多个与之关联的地址。

有关客户资源的更多信息，请参见客户。

您可以使用客户地址做什么

Shopify API使您可以使用“客户地址”资源执行以下操作。这些常规操作的更详细的版本可能可用：

客户地址属性

地址1	`plain "address1": "1 Rue des Carrieres"` 客户的邮寄地址
地址2	`plain "address2": "Suite 1234"` 客户的邮寄地址的附加字段。
城市	`plain "city": "Montreal"` 客户的城市，城镇或村庄。
国家	`plain "country": "Canada"` 客户所在的国家/地区。
国家代码只读	`plain "country_code": "CA"` 与客户所在国家/地区相对应的两个字母的国家/地区代码。
国家的名字	`plain "country_name": "Canada"` 客户的标准化国家/地区名称。
公司	`plain "company": "Fancy Co."` 客户的公司。
名	`plain "first_name": "Samuel"` 客户的名字。
姓	`plain "last_name": "de Champlain"` 客户的姓氏。
姓名	`plain "name": "Samuel de Champlain"` 客户的名字和姓氏。
电话	`plain "phone": "819-555-5555"` 客户在此地址的电话号码。
省	`plain "province": "Quebec"` 客户的地区名称。通常是一个省，州或县。
province_code 只读	`plain "province_code": "QC"` 客户所在区域的两个字母的代码。
压缩	`plain "zip": "G1R 4P5"` 客户的邮政编码，也称为邮政编码，邮政编码，Eircode等。

终点

得到/admin/api/2021-01/customers/{customer_id}/addresses.json 检索客户的地址列表。注意：从2019-10版本开始，此端点通过使用响应标头中提供的链接来实现分页。发送<font style="background-color:#F4F6F8;">page</font>参数将返回错误。要了解更多信息，请参阅向分页的REST Admin API端点发出请求。

检索所有客户的地址

GET /admin/api/2021-01/customers/207119551/addresses.json

查看回应

为客户检索数量有限的地址

GET /admin/api/2021-01/customers/207119551/addresses.json?limit=1

查看回应

得到/admin/api/2021-01/customers/{customer_id}/addresses/{address_id}.json 检索详细信息单个客户地址。

检索单个客户地址

GET /admin/api/2021-01/customers/207119551/addresses/207119551.json

查看回应

邮政/admin/api/2021-01/customers/{customer_id}/addresses.json 为客户创建一个新地址。

为客户创建一个新地址

POST /admin/api/2021-01/customers/207119551/addresses.json

{

“地址” ： {

“ address1” ：“ 1 Rue des Carrieres”，
“ address2” ：“套房1234”，
“ city” ：“蒙特利尔”，
“ company” ：“ Fancy Co.”，
“ first_name” ：“塞缪尔”，
“ last_name” ：“ de Champlain”，
“电话” ：“ 819-555-5555”，
“省” ：“魁北克”，
“ country” ：“ Canada”，
“ zip” ：“ G1R 4P5”，
“名称” ：“尚普兰（Samuel de Champlain）”，
“ province_code” ：“ QC”，
“ country_code” ：“ CA”，
“ country_name” ：“加拿大”

}

查看回应

放/admin/api/2021-01/customers/{customer_id}/addresses/{address_id}.json 更新现有的客户地址。

更新客户地址的邮政编码

PUT /admin/api/2021-01/customers/207119551/addresses/207119551.json

{

“地址” ： {

“ id” ：207119551，
“ zip” ：“ 90210”

}

查看回应

删除/admin/api/2021-01/customers/{customer_id}/addresses/{address_id}.json 从客户的地址列表中删除地址。

删除客户的默认地址失败并返回错误

删除/admin/api/2021-01/customers/207119551/addresses/207119551.json

查看回应

删除客户地址

删除/admin/api/2021-01/customers/207119551/addresses/1053317289.json

查看回应

放/admin/api/2021-01/customers/{customer_id}/addresses/set.json?address_ids[]=1053317286&operation=destroy 对多个客户地址执行批量操作。

销毁多个客户地址

PUT /admin/api/2021-01/customers/207119551/addresses/set.json?address_ids[]=1053317286&operation=destroy

查看回应

放/admin/api/2021-01/customers/{customer_id}/addresses/{address_id}/default.json 设置客户的默认地址。

为客户设置默认地址

PUT /admin/api/2021-01/customers/207119551/addresses/1053317287/default.json

查看回应