淘宝获取收货地址列表的 API

 注册获取专属于你的key和secret

一、参数

公共参数

请求地址: https://api-gw.onebound.cn/taobao/buyer_address_list

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

响应参数

Version: Date:

名称	类型	必须	示例值	描述
addressDetail	String	0	人民路313号（秦皇食府对面）万邦科技有限公司	详细地址
area	String	0	渝水区	地区
city	String	0	新余市	城市
fullAddress	String	0	江西省/新余市/渝水区/城南街道	地址信息
fullName	String	0	张三	收货人姓名
mobile	String	0	13979008888	手机号码
phoneInternationalCode	String	0	86	电话国际代码
phone	String	0	0790-6666666	电话号码全部
phoneCode	String	0	6666666	电话号码
phoneSection	String	0	0790	区号
post	String	0	338000	邮编
province	String	0	江西省	省份
town	String	0	城南街道	镇/街道
x	String	0	27.806949	纬度
y	String	0	114.944236	经度

二、示例

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/buyer_address_list/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

{
      "data": [
          {
              "active": false,
              "addressDetail": "人民路313号（秦皇食府对面）万邦科技有限公司",
              "area": "渝水区",
              "areaDivisionCode": 360502,
              "buidFromChindIframe": true,
              "chinaLand": true,
              "city": "新余市",
              "cityDivisionCode": 360500,
              "confidence": 93,
              "country": "",
              "countryDivisionCode": 1,
              "defaultAddress": true,
              "defaultCode": 1,
              "deliverId": 6845502554,
              "divisionCode": "360502",
              "fillPoiAddress": false,
              "forgin": false,
              "fullAddress": "江西省/新余市/渝水区/城南街道",
              "fullName": "张三",
              "gAT": false,
              "gmtCreate": 1480486142000,
              "gmtModified": 1495477303000,
              "guoguoAddress": false,
              "hKOrMacauOrTW": false,
              "helpBuyAddress": false,
              "illegalCunTaoAddress": false,
              "isPoiAddress": false,
              "kinshipDeliverAddress": false,
              "lastChoose": false,
              "locationEnable": false,
              "mobile": "13979008888",
              "mobileCode": "86",
              "needToUpgrade": false,
              "needUpgrade": false,
              "overSea": false,
              "phone": "0790-6666666",
              "phoneCode": "6666666",
              "phoneInternationalCode": "86",
              "phoneSection": "0790",
              "post": "338000",
              "provDivisionCode": 360000,
              "province": "江西省",
              "tAIWAN": false,
              "town": "城南街道",
              "townDivisionCode": 360502001,
              "userNumId": 2601011849,
              "x": "27.806949",
              "y": "114.944236"
          },
          {
              "active": false,
              "addressDetail": "康泰路62号 玫瑰小区6期",
              "area": "渝水区",
              "areaDivisionCode": 360502,
              "buidFromChindIframe": true,
              "chinaLand": true,
              "city": "新余市",
              "cityDivisionCode": 360500,
              "confidence": 98,
              "country": "",
              "countryDivisionCode": 1,
              "defaultAddress": false,
              "defaultCode": 0,
              "deliverId": 6375759746,
              "divisionCode": "360502",
              "fillPoiAddress": false,
              "forgin": false,
              "fullAddress": "江西省/新余市/渝水区/城南街道",
              "fullName": "李四",
              "gAT": false,
              "gmtCreate": 1465220621000,
              "gmtModified": 1495681978000,
              "guoguoAddress": false,
              "hKOrMacauOrTW": false,
              "helpBuyAddress": false,
              "illegalCunTaoAddress": false,
              "isPoiAddress": false,
              "kinshipDeliverAddress": false,
              "lastChoose": false,
              "locationEnable": false,
              "mobile": "13979008888",
              "mobileCode": "86",
              "needToUpgrade": false,
              "needUpgrade": false,
              "overSea": false,
              "post": "338000",
              "provDivisionCode": 360000,
              "province": "江西省",
              "tAIWAN": false,
              "town": "城南街道",
              "townDivisionCode": 360502001,
              "userNumId": 2601011849,
              "x": "27.79764",
              "y": "114.950212"
          }
      ],
      "from": "taobao",
      "error": "",
      "reason": "",
      "error_code": "0000",
      "cache": 0,
      "api_info": "today:7 max:10000",
      "execution_time": 0.704,
      "server_time": "Beijing/2021-03-16 10:47:24",
      "client_ip": "127.0.0.1",
      "call_args": [],
      "api_type": "taobao",
      "translate_language": "zh-CN",
      "translate_engine": "google_cn",
      "server_memory": "5.5MB",
      "request_id": "0.60501c3b778b7"
  }