專注于數(shù)據(jù)共享與專業(yè)API數(shù)據(jù)接口:IP地址/域名查詢接口API
1、接口說明
如果傳入的數(shù)據(jù)是 IP 地址,那么直接返回 IP 地址對應(yīng)的?。ㄊ?自治區(qū))、市(區(qū)/自治州)、區(qū)(縣/市/區(qū))以及運營商名稱;如果傳入的數(shù)據(jù)是域名,則先解析出域名對應(yīng)的 IP 地址,再返回 IP 地址對應(yīng)的?。ㄊ?自治區(qū))、市(區(qū)/自治州)、區(qū)(縣/市/區(qū))以及運營商名稱。
2、接口描述
2.1、功能描述
獲取 IP 地址對應(yīng)的省(市/自治區(qū))、市(區(qū)/自治州)、區(qū)(縣/市/區(qū))以及運營商名稱;或者查詢域名解析到的 IP 地址對應(yīng)的?。ㄊ?自治區(qū))、市(區(qū)/自治州)、區(qū)(縣/市/區(qū))以及運營商名稱。
2.2、URL 示例
1)http 協(xié)議:
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 協(xié)議:
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、請求參數(shù)
3.1、數(shù)據(jù)包體
{ "type": "get", "appid": "1000xxxx", "module": "getIPAddressInfo", "ip": "127.0.0.1", "sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4" }
3.2、參數(shù)說明
參數(shù) | 必選 | 類型 | 描述 |
---|---|---|---|
type | 否 | string | 授權(quán)接口的請求方式 |
appid | 是 | string | 授權(quán)接口的 AppID,請?zhí)顚懩谖乙楣倬W(wǎng)上申請到的 AppID |
module | 是 | string | 目標請求的數(shù)據(jù)模塊,查詢IP地址/域名信息為:getIPAddressInfo |
ip | 是 | string | 目標要查詢的IP地址,也可以是一個標準格式的域名,如:woyaocha.net |
sign | 是 | string | 請求憑證,具體計算方式見下面的其他說明 |
3.3、其他說明
1)type:可選值 get,如果賦值 get,則以 get 方式提交數(shù)據(jù);默認以 post 方式提交數(shù)據(jù);
2)sign:簽名校驗,根據(jù)公式$sign=sha256(appid=$appid&module=getIPAddressInfo&ip=$ip&appkey=$appkey)
生成;其中:appkey 為授權(quán)接口的 AppKey,請?zhí)顚懩谖乙楣倬W(wǎng)上申請到的 AppKey 。點擊鏈接申請:https://console.ebaitian.cn/control/api_mng/api_idx.html
構(gòu)造偽代碼如下:
string type = "get"; //請求方式,可以賦值為:post string appid = "1000xxxx"; //sdkappid 對應(yīng)的 appid,需要業(yè)務(wù)方高度保密 string module = "getIPAddressInfo"; //請求的數(shù)據(jù)模塊,此處賦值:getIPAddressInfo string ip = "127.0.0.1"; //要查詢的IP地址,也可以是一個標準格式的域名 string sign = sha256(appid=1000xxxx&module=getIPAddressInfo&ip=127.0.0.1&appkey=56cf61af4b7897e704f67deb88ae8f24);
4、響應(yīng)參數(shù)
4.1、數(shù)據(jù)包體
{ "result":1, "description":"TRUE", "flag":"", "ipInfo":{ "address":"湖北省武漢市", "isp":"電信DNS服務(wù)器", "notes":"" } }
4.2、參數(shù)說明
參數(shù) | 必選 | 類型 | 描述 |
---|---|---|---|
result | 是 | string | 接口響應(yīng)結(jié)果:0-失??;1成功 |
description | 是 | string | 接口響應(yīng)描述:一般為 TURE(result=1) 與 FALSE(result=0),或者返回錯誤信息 |
flag | 否 | string | 錯誤說明,沒有錯誤則返回空 |
ipInfo | 是 | object | 返回IP地址信息,或域名對應(yīng)的IP地址信息 |
ipInfo 參數(shù)說明:
參數(shù) | 必選 | 類型 | 描述 |
---|---|---|---|
address | 是 | string | 地區(qū)信息,即 IP 地址對應(yīng)的?。ㄊ?自治區(qū))、市(區(qū)/自治州)、區(qū)(縣/市/區(qū)) |
isp | 是 | string | ISP 運營商或使用單位 |
notes | 否 | string | 其他備注信息,一般為空 |
本文為「本站原創(chuàng)」,未經(jīng)我們許可,嚴謹任何人或單位以任何形式轉(zhuǎn)載或刊載本文章,我們保留依法追究侵權(quán)的權(quán)力!
微信聯(lián)系我們
使用微信掃一掃
昵稱:億百天技術(shù)
公司:湖北億百天信息技術(shù)有限公司
電話:027-88773336
手機:15342213852
郵箱:serviceebaitian.cn
我來說兩句