专注于数据共享与专业API数据接口:IP地址/域名查询接口API

1、接口说明

如果传入的数据是 IP 地址,那么直接返回 IP 地址对应的省(市/自治区)、市(区/自治州)、区(县/市/区)以及运营商名称;如果传入的数据是域名,则先解析出域名对应的 IP 地址,再返回 IP 地址对应的省(市/自治区)、市(区/自治州)、区(县/市/区)以及运营商名称。

2、接口描述

2.1、功能描述

获取 IP 地址对应的省(市/自治区)、市(区/自治州)、区(县/市/区)以及运营商名称;或者查询域名解析到的 IP 地址对应的省(市/自治区)、市(区/自治州)、区(县/市/区)以及运营商名称。

2.2、URL 示例

1)http 协议

POST 方式请求:

http://cha.ebaitian.cn/api/json?appid=xxx&module=getIPAddressInfo&ip=xxx&sign=xxx

GET 方式请求:

http://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getIPAddressInfo&ip=xxx&sign=xxx

2)https 协议:

POST 方式请求:

https://cha.ebaitian.cn/api/json?appid=xxx&module=getIPAddressInfo&ip=xxx&sign=xxx

GET 方式请求:

https://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getIPAddressInfo&ip=xxx&sign=xxx

3、请求参数

3.1、数据包体

{
    "type": "get",
    "appid": "1000xxxx",
    "module": "getIPAddressInfo",
    "ip": "127.0.0.1",
    "sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4"
}

3.2、参数说明

参数必选类型描述
typestring授权接口的请求方式
appidstring授权接口的 AppID,请填写您在我要查官网上申请到的 AppID
modulestring目标请求的数据模块,查询IP地址/域名信息为:getIPAddressInfo
ipstring目标要查询的IP地址,也可以是一个标准格式的域名,如:woyaocha.net
signstring请求凭证,具体计算方式见下面的其他说明

3.3、其他说明

1)type:可选值 get,如果赋值 get,则以 get 方式提交数据;默认以 post 方式提交数据;

2)sign:签名校验,根据公式$sign=sha256(appid=$appid&module=getIPAddressInfo&ip=$ip&appkey=$appkey)生成;其中:appkey 为授权接口的 AppKey,请填写您在我要查官网上申请到的 AppKey 。点击链接申请:https://console.ebaitian.cn/control/api_mng/api_idx.html

构造伪代码如下:

string type = "get";                    //请求方式,可以赋值为:post
string appid = "1000xxxx";              //sdkappid 对应的 appid,需要业务方高度保密
string module = "getIPAddressInfo";     //请求的数据模块,此处赋值:getIPAddressInfo
string ip = "127.0.0.1";                //要查询的IP地址,也可以是一个标准格式的域名
string sign = sha256(appid=1000xxxx&module=getIPAddressInfo&ip=127.0.0.1&appkey=56cf61af4b7897e704f67deb88ae8f24);

4、响应参数

4.1、数据包体

{
    "result":1,
    "description":"TRUE",
    "flag":"",
    "ipInfo":{
        "address":"湖北省武汉市",
        "isp":"电信DNS服务器",
        "notes":""
    }
}

4.2、参数说明

参数必选类型描述
resultstring接口响应结果:0-失败;1成功
descriptionstring接口响应描述:一般为 TURE(result=1) 与 FALSE(result=0),或者返回错误信息
flagstring错误说明,没有错误则返回空
ipInfoobject返回IP地址信息,或域名对应的IP地址信息

ipInfo 参数说明:

参数必选类型描述
addressstring地区信息,即 IP 地址对应的省(市/自治区)、市(区/自治州)、区(县/市/区)
ispstringISP 运营商或使用单位
notesstring其他备注信息,一般为空
点赞 0 分享
本文为「本站原创」,未经我们许可,严谨任何人或单位以任何形式转载或刊载本文章,我们保留依法追究侵权的权力!

微信联系我们

湖北亿百天信息技术有限公司客户服务

使用微信扫一扫

昵称:客户服务

公司:湖北亿百天信息技术有限公司

电话:027-88773336

手机:15342213852

邮箱:serviceebaitian.cn

相关栏目

加载中...

成为会员立享特权

立即注册亿百天公司会员,在线联系客服立即享受会员特权,还有丰厚礼品赠送;签约时可以享受特低折扣优惠,期待您的加入!

客服热线:400-840-3336

我们为您提供个性化的售前咨询服务,及全面的技术售后服务。