文档中心 > API类目 > 驿马前台api

cainiao.yima.app.division.query (查询三级地址)

获取省市区信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
version Number 必须 1 客户端当前版本

响应参数

名称 类型 示例值 描述
data YmAddressAreaDto demo demo
  • └ address_file_url
  • String
  • http://xxx
  • 地址文件下载地址
  • └ version
  • Number
  • 1
  • 服务端当前版本
status_code String 1001 状态码
status_message String 系统异常 状态信息
is_success Boolean false 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoYimaAppDivisionQueryRequest req = new CainiaoYimaAppDivisionQueryRequest();
req.setVersion(1L);
CainiaoYimaAppDivisionQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
<cainiao_yima_app_division_query_response>
    <data>
        <address_file_url>http://xxx</address_file_url>
        <version>1</version>
    </data>
    <status_code>1001</status_code>
    <status_message>系统异常</status_message>
    <is_success>false</is_success>
</cainiao_yima_app_division_query_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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

返回
顶部