服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

【京东地址库】接口导航


1. 获取省级列表  2. 获取市级信息列表
3. 获取区县级信息列表 4. 获取乡镇级信息列表
5. 返回IP地址对应的物理地址信息  

1. 获取省级列表
接口名称 

jingdong.area.province.get

API用户授权类型

不需要

系统级别输入参数

名称类型是否必须描述
methodString是API接口名称
access_tokenString否采用OAuth授权方式为必填参数
app_keyString是应用的app_key
signString是签名
timestampString是时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
formatString否暂时只支持json
vString否API协议版本，可选值:2.0

应用级输入参数

名称类型是否必须示例值描述
    

此接口无需输入应用级参数，但需要构建空参数360buy_param_json={}

返回结果

名称类型示例值描述
province_areas  AreaListBeanVO[ ]    所有省级列表结果 
success Boolean   是否成功 

Area属性

名称类型是否必须示例值描述
id Number 否 id 
name String 否 名称 
cod Boolean 否 是否支持京东配送货到付款 
is3cod String 否 是否支持第三方配送货到付款

返回示例

JSON数据格式

  {
  "jingdong_area_province_get_response":{
  "msg":{
  "province_areas":{
  "id":"",
"cod":"",
"name":""
  },
"success":""
  }
  }

  }

SDK调用代码示例

 public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
AreaProvinceGetRequest request=new AreaProvinceGetRequest();
AreaProvinceGetResponse response=client.execute(request);

2. 获取市级信息列表
接口名称 

jingdong.area.city.get

API用户授权类型

不需要

系统级别输入参数

名称类型是否必须描述
methodString是API接口名称
access_tokenString否采用OAuth授权方式为必填参数
app_keyString是应用的app_key
signString是签名
timestampString是时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
formatString否暂时只支持json
vString否API协议版本，可选值:2.0

应用级输入参数

名称类型是否必须示例值描述
parent_id Number  是   省id 

返回结果

名称类型示例值描述
city_areas  AreaListBeanVO[ ]    该省下的所有市级列表结果 
success Boolean   是否成功 

AreaListBeanVO属性

名称类型是否必须示例值描述
id Number  否   id 
name String  否   名称 
cod Boolean  否   是否支持京东配送货到付款 
is3codString否 是否支持第三方配送货到付款

返回示例

JSON数据格式

{
  "jingdong_area_city_get_response":{
  "msg":{
  "city_areas":{
  "id":"",
"cod":"",
"name":""
  },
"success":""
  }
  }
  }

SDK调用代码示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
AreaCityGetRequest request=new AreaCityGetRequest();
request.setParentId( 123 );
AreaCityGetResponse response=client.execute(request);
3. 获取区县级信息列表
接口名称 

jingdong.area.county.get

API用户授权类型

不需要

系统级别输入参数

名称类型是否必须描述
methodString是API接口名称
access_tokenString否采用OAuth授权方式为必填参数
app_keyString是应用的app_key
signString是签名
timestampString是时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
formatString否暂时只支持json
vString否API协议版本，可选值:2.0

应用级输入参数

名称类型是否必须示例值描述
parent_id
Number  是   市id

返回结果

名称类型示例值描述
county_areas  AreaListBeanVO[ ]    该市下的所有区县级列表结果 
success Boolean   是否成功 

AreaListBeanVO属性

名称类型是否必须示例值描述
id Number  否   id 
name String  否   名称 
cod Boolean  否   是否支持京东配送货到付款 
is3cod String 否 是否支持第三方配送货到付款

返回示例

JSON数据格式

{
  "jingdong_area_county_get_response":{
  "msg":{
  "county_areas":{
  "id":"",
"cod":"",
"name":""
  },
"success":""
  }
  }
  }

SDK调用代码示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
AreaCountyGetRequest request=new AreaCountyGetRequest();
request.setParentId( 123 );
AreaCountyGetResponse response=client.execute(request);
4. 获取乡镇级信息列表
接口名称 

jingdong.area.town.get

API用户授权类型

不需要

系统级别输入参数

名称类型是否必须描述
methodString是API接口名称
access_tokenString否采用OAuth授权方式为必填参数
app_keyString是应用的app_key
signString是签名
timestampString是时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
formatString否暂时只支持json
vString否API协议版本，可选值:2.0

应用级输入参数

名称类型是否必须示例值描述
parent_idNumber  是  县id

返回结果

名称类型示例值描述
town_areasAreaListBeanVO[ ]  该区县下的所有乡镇级列表结果
success Boolean   是否成功 

AreaListBeanVO属性

名称 类型 是否必须 示例值 描述
id  Number  否   id 
name  String  否   名称 
cod  Boolean  否   是否支持京东配送货到付款 
is3cod String 否 是否支持第三方配送货到付款

返回示例

JSON数据格式

{
  "jingdong_area_town_get_response":{
  "msg":{
  "town_areas":{
  "id":"",
"cod":"",
"name":""
  },
"success":""
  }
  }
  }

SDK调用代码示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
AreaTownGetRequest request=new AreaTownGetRequest();
request.setParentId( 123 );
AreaTownGetResponse response=client.execute(request);
5. 返回IP地址对应的物理地址信息
接口名称 

jingdong.area.ip.query

API用户授权类型

不需要

系统级别输入参数

名称类型是否必须描述
methodString是API接口名称
access_tokenString否采用OAuth授权方式为必填参数
app_keyString是应用的app_key
signString是签名
timestampString是时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
formatString否暂时只支持json
vString否API协议版本，可选值:2.0

应用级输入参数

名称类型是否必须示例值描述
ip
String 否   IP地址,格式：221.237.152.76 

返回结果

名称类型示例值描述
jip_response
IpLookupResponse   国家 、省（自治区或直辖市）、市（县）、区 

IpLookupResponse 属性

名称类型是否必须示例值描述
status Number  否   status的值的含义为，200：成功，400：非法IP地址/IP地址不能为空，403：禁止访问 ，404：无此IP的数据 
message String  否   status描述 
data Location  否    

Location 属性

名称类型是否必须示例值描述
country String  否   国家 
province String  否   省份 
city String  否   城市 
district String  否   区县 
subdistrict String  否   乡镇 
community String  否   社区 
road String  否   路名 
desc String  否   描述信息

返回示例

JSON数据格式

{
  "jingdong_area_ip_query_response":{
  "jip_response":{
  "message":"",
"status":"",
"data":{
  "desc":"",
"community":"",
"province":"",
"road":"",
"district":"",
"subdistrict":"",
"city":"",
"country":""
  }
  }
  }
  }

SDK调用代码示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
AreaIpQueryRequest request=new AreaIpQueryRequest();
request.setIp( "jingdong" );
AreaIpQueryResponse response=client.execute(request);