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


加載中...
我來說兩句