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、参数说明

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、参数说明

ipInfo 参数说明：