文档中心 > API类目 > 天猫供应链

taobao.logistics.address.query (标准地址id查询接口)

标准地址id查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
address_request AddressRequest 必须 转换地址ID查询参数
  • └ request_id
  • String
  • 必须
  • 1691997065571
  • 业务请求ID,用于做幂等
  • └ request_time
  • Number
  • 必须
  • 1691997065571
  • 时间戳(毫秒)
  • address_names
  • AddressName []
  • 必须
  • []
  • 中文地址信息
  • └ province
  • String
  • 必须
  • 浙江省
  • └ city
  • String
  • 可选
  • 杭州市
  • └ area
  • String
  • 可选
  • 余杭区
  • └ town
  • String
  • 可选
  • 五常街道
  • 街道
  • └ get_children
  • Boolean
  • 可选
  • true
  • 是否需要下一级地址信息 true|false 未填写时默认为false;传true时,会返回下一级级全量地址信息及地址id

响应参数

名称 类型 示例值 描述
message String 213da4a616969025804403311d10be traceId
result String 1 result
data Json data

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsAddressQueryRequest req = new LogisticsAddressQueryRequest();
LogisticsAddressQueryRequest.AddressRequest obj1 = new LogisticsAddressQueryRequest.AddressRequest();
obj1.setRequestId("1691997065571");
obj1.setRequestTime(1691997065571L);
List<LogisticsAddressQueryRequest.AddressName> list3 = new ArrayList<LogisticsAddressQueryRequest.AddressName>();
LogisticsAddressQueryRequest.AddressName obj4 = new LogisticsAddressQueryRequest.AddressName();
list3.add(obj4);
obj4.setProvince("浙江省");
obj4.setCity("杭州市");
obj4.setArea("余杭区");
obj4.setTown("五常街道");
obj1.setAddressNames(list3);
obj1.setGetChildren(true);
req.setAddressRequest(obj1);
LogisticsAddressQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_address_query_response>
    <message>213da4a616969025804403311d10be</message>
    <result>1</result>
</logistics_address_query_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

返回
顶部