一、接口介绍
根据客户上网所用信息,取得客户端访问互联网时的外网ip及对应的地理城市信息。
如何进行简单的在线调用,查看调用效果?
1、通过以下链接点击【在线调试】
2、点击调用接口,即可得到调用结果,如下图所示
二、接入点功能
获取外网IP
接入点说明:
不需要额外的参数。只要调用此接口,接口将返回用者所在ip的信息及地址位置。
接口地址:
http[s]://route.showapi.com/632-1?showapi_appid=替换自己的值&showapi_sign=替换自己的值
返回格式:
json
更新频率:
实时获取您的外网ip情况
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//Maven仓库:https://mvnrepository.com/artifact/com.showapi.javasdk/showapi_java_sdk/1.0.0
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest("http://route.showapi.com/632-1","showapi_appid","showapi_sign")
.post();
System.out.println(res);
返回示例
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"region": "云南",
"county": "",
"isp": "移动",
"continents": "亚洲",
"en_name": "China",
"city_code": "530100",
"lnt": "102.712251",
"lat": "25.040609",
"en_name_short": "CN",
"ip": "183.225.1.165",
"city": "昆明",
"country": "中国"
}
}
1、系统级返回(所有接入点都会返回的参数)
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code | int | 0 | 查看错误码 |
showapi_fee_num | int | 1 | 计费次数标识。为0时表示不计费。大于0时代表计费几次。比如发送长短信时可能会多次计费。 通常此字段值为1,代表计费1次。 |
showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
2、错误码 (showapi_res_code)
状态码 | 描述 |
---|---|
0 | 成功 |
-1 | 系统调用错误 |
-2 | 可调用次数或金额为0 |
-3 | 读取超时 |
-4 | 服务端返回数据解析错误 |
-5 | 后端服务器DNS解析错误 |
-6 | 服务不存在或未上线 |
-7 | API创建者的网关资源不足 |
-3 | 读取超时 |
-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权限无效 |