阿里云市场-高德-IP定位

IP定位

接口地址：http://route.showapi.com/1983-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 

参数名称	类型	默认值	示例值	必须	描述
ip	String		123.125.71.38	是	需要搜索的IP地址（仅支持国内）

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1983-1","my_appId","my_appSecret") .addTextPara("ip","123.125.71.38") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
status	String	1	返回结果状态值 值为0或1,0表示失败；1表示成功
info	String	OK	返回状态说明 返回状态说明，status为0时，info返回错误原因，否则返回“OK”。
infocode	String	10000	状态码 返回状态说明,10000代表正确,详情参阅info状态表
province	String	北京市	省份名称 若为直辖市则显示直辖市名称； 如果在局域网 IP网段内，则返回“局域网”； 非法IP以及国外IP则返回空
city	String	北京市	城市名称 若为直辖市则显示直辖市名称； 如果为局域网网段内IP或者非法IP或国外IP，则返回空
adcode	String	110000	城市的adcode编码
rectangle	String	116.0119343,39.66127144;116.7829835,40.2164962	所在城市矩形区域范围 所在城市范围的左下右上对标对
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "2e0be72becda41f3b30edc1180ed28e7", "showapi_res_code": 0, "showapi_res_body": { "status": "1", "info": "OK", "infocode": "10000", "province": "北京市", "city": "北京市", "adcode": "110000", "rectangle": "116.0119343,39.66127144;116.7829835,40.2164962" } }