文档中心 > API类目 > ICBU-交易

alibaba.trade.address.get (国际站交易地址库通用查询接口)

国际站交易地址库通用查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
address_request TradeEcologyAddressQueryRequest 可选 {}
  • └ param
  • String
  • 可选
  • US
  • 此参数 有时候是必传的,请仔细看下面type的解释
  • └ type
  • String
  • 必须
  • countryList
  • 1. 指定type=countryList 时,代表查询国家列表,param 可不传
    2. 指定type=countryIso时,代表查询某个国家下面的省份列表,此时param必传,传国家 iso 字段
    3. 指定type=provinceId时,代表查询某个省份下面的城市列表,此时param必传,传省份 id 字段

响应参数

名称 类型 示例值 描述
value AddressLibrary {} 对象
  • country_entities
  • CountryEntity []
  • []
  • 国家列表
  • └ iso
  • String
  • US
  • 国家码
  • └ country_flag
  • String
  • https://u.alicdn.com/mobile/g/common/flags/1.0.0/assets/us.png
  • 国家图标
  • └ name
  • String
  • United States of America
  • 国家英文名
  • provinces
  • RegionEntity []
  • []
  • 省份
  • └ name
  • String
  • Alabama
  • 省份英文名
  • └ id
  • Number
  • 922865760000000000
  • 省份id (也就是code)
  • └ country_name
  • String
  • United States
  • 所属国家名
  • └ iso
  • String
  • AL
  • 省iso
  • cities
  • RegionEntity []
  • []
  • 城市列表
  • └ name
  • String
  • Acoma
  • 城市英文名
  • └ province_id
  • Number
  • 922865760000000000
  • 所属省份id
  • └ id
  • String
  • 922865765908000000
  • 城市id(就是code)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTradeAddressGetRequest req = new AlibabaTradeAddressGetRequest();
AlibabaTradeAddressGetRequest.TradeEcologyAddressQueryRequest obj1 = new AlibabaTradeAddressGetRequest.TradeEcologyAddressQueryRequest();
obj1.setParam("US");
obj1.setType("countryList");
req.setAddressRequest(obj1);
AlibabaTradeAddressGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_trade_address_get_response>
    <value>
        <country_entities>
            <country_entity>
                <iso>US</iso>
                <country_flag>https://u.alicdn.com/mobile/g/common/flags/1.0.0/assets/us.png</country_flag>
                <name>United States of America</name>
            </country_entity>
        </country_entities>
        <provinces>
            <region_entity>
                <name>Alabama</name>
                <id>922865760000000000</id>
                <country_name>United States</country_name>
                <iso>AL</iso>
            </region_entity>
        </provinces>
        <cities>
            <region_entity>
                <name>Acoma</name>
                <province_id>922865760000000000</province_id>
                <id>922865765908000000</id>
            </region_entity>
        </cities>
    </value>
</alibaba_trade_address_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部