预订宝/IP地址归属地查询系统
来自站长百科
IP地址归属地查询系统基于著名的纯真IP数据库实现，预订宝提供该实用工具的API是因为IP查询系统实现简单，容易理解，适合开发者入门学习之用。
实际上，并不建议开发者使用该API来查询IP地址，如果生产环境需要此功能，应当在本地程序中自行实现查询效率更高、稳定性更好的功能。
接口概述[ ]
- 接口地址：http://api.yudingbao.net/v1.0/generictools/ipsearcher.ashx
- 说明：调用本接口可以查询IP地址的归属地信息。
- 鉴权方式：本接口使用密钥标记鉴权，不严格要求调用者的身份。使用本接口需要申请实用工具授权。
- 响应模式：JSON、JSONP、XML
获取版本信息[ ]
- 调用方式：GET
- 动作：getVersion
- 参数：无
示例代码[ ]
请求示例
<!--请求示例，该接口的访问类同于如下表单的提交，请留意URL中的"act"参数--> <form id="myForm" method="post" action="http://api.yudingbao.net/v1.0/generictools/ipsearcher.ashx"> <p> <input id="act" name="act" value="getVersion" type="text" /> </p> <p> <!--指定响应格式为XML，这里以XML为例--> <input id="format" name="format" value="xml" type="text" /> <!--指定响应体应当是已格式化的，便于阅读代码，在生产环境中应当将该值设置为false--> <input id="indent" name="indent" value="true" type="text" /> <!--产品编号。在我的账户-分销产品的应用列表中可以找到该参数的值。--> <input id="aid" name="aid" value="78663" type="text" /> <!--接口密钥。在我的账户-分销产品的应用列表中可以找到该参数的值。--> <input id="key" name="key" value="f9308fe421092586ff7897bc26d9b88178e5607195c9a8df6c2a226c6589fa1b" type="text" /> <!--应用程序授权编号及公钥，这是可选的--> <input id="sid" name="sid" value="" type="text"> <input id="sKey" name="sKey" value="" type="text"> </p> <p> <input id="submit" name="submit" type="submit" value="提交" /> </p> </form>
XML响应
<!--XML响应--> <?xml version="1.0" encoding="utf-8"?> <HttpResponse> <Status type="number">0</Status> <Messages type="array"> </Messages> <ResponseBody type="object"> <FileName type="string">QQWry.DAT</FileName> <Copyright type="string">纯真网络</Copyright> <UpdateTime type="string">Sun, 04 May 0042 16:00:00 GMT</UpdateTime> <RecordCount type="number">424032</RecordCount> </ResponseBody> </HttpResponse>
JSON响应
// Json响应
{
"Status" : 0,
"Messages" : [],
"ResponseBody" : {
"FileName" : "QQWry.DAT",
"Copyright" : "纯真网络",
"UpdateTime" : Date(1304524800000),
"RecordCount" : 424032
}
}
JSONP响应
// JsonP响应
jsoncallback({
"Status" : 0,
"Messages" : [],
"ResponseBody" : {
"FileName" : "QQWry.DAT",
"Copyright" : "纯真网络",
"UpdateTime" : Date(1304524800000),
"RecordCount" : 424032
}
});
查询IP地址[ ]
- 调用方式：POST
- 动作：query
- 参数：见参数说明
参数说明[ ]
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| ipaddress | array | 一个数组。包含要查询的IP地址的字符串形式的集合。 |
| 例如：[ '192.168.1.1', '215.216.12.34' ] |
示例代码[ ]
请求示例
<!--请求示例，该接口的访问类同于如下表单的提交，请留意URL中的"act"参数--> <form id="myForm" method="post" action="http://api.yudingbao.net/v1.0/generictools/ipsearcher.ashx"> <p> <input id="act" name="act" value="query" type="text" /> </p> <p> <input id="ipaddress1" name="ipaddress" value="192.168.1.1" type="text"> <input id="ipaddress2" name="ipaddress" value="202.104.228.23" type="text"> <input id="ipaddress3" name="ipaddress" value="10.3.45.20" type="text"> <input id="ipaddress4" name="ipaddress" value="8.8.8.8" type="text"> <input id="ipaddress5" name="ipaddress" value="8.8.4.4" type="text"> <input id="ipaddress6" name="ipaddress" value="211.222.233.244" type="text"> </p> <p> <!--指定响应格式为XML，这里以XML为例--> <input id="format" name="format" value="xml" type="text" /> <!--指定响应体应当是已格式化的，便于阅读代码，在生产环境中应当将该值设置为false--> <input id="indent" name="indent" value="true" type="text" /> <!--产品编号。在我的账户-分销产品的应用列表中可以找到该参数的值。--> <input id="aid" name="aid" value="78663" type="text" /> <!--接口密钥。在我的账户-分销产品的应用列表中可以找到该参数的值。--> <input id="key" name="key" value="f9308fe421092586ff7897bc26d9b88178e5607195c9a8df6c2a226c6589fa1b" type="text" /> <!--应用程序授权编号及公钥，这是可选的--> <input id="sid" name="sid" value="" type="text"> <input id="sKey" name="sKey" value="" type="text"> </p> <p> <input id="submit" name="submit" value="提交" type="submit"> </p> </form>
XML响应
<!--XML响应--> <?xml version="1.0" encoding="utf-8"?> <HttpResponse> <Status type="number">0</Status> <Messages type="array"> </Messages> <ResponseBody type="array"> <item type="object"> <IPString type="string">192.168.1.1</IPString> <Country type="string">局域网</Country> <Area type="string">对方和您在同一内部网</Area> <Address type="number">16885952</Address> </item> <item type="object"> <IPString type="string">202.104.228.23</IPString> <Country type="string">广东省揭阳市</Country> <Area type="string">(棉湖)电信ADSL</Area> <Address type="number">400845002</Address> </item> <item type="object"> <IPString type="string">10.3.45.20</IPString> <Country type="string">局域网</Country> <Area type="string">对方和您在同一内部网</Area> <Address type="number">338494218</Address> </item> <item type="object"> <IPString type="string">8.8.8.8</IPString> <Country type="string">美国</Country> <Area type="string">加利福尼亚州山景市谷歌公司DNS服务器</Area> <Address type="number">134744072</Address> </item> <item type="object"> <IPString type="string">8.8.4.4</IPString> <Country type="string">美国</Country> <Area type="string">加利福尼亚州山景市谷歌公司DNS服务器</Area> <Address type="number">67373064</Address> </item> <item type="object"> <IPString type="string">211.222.233.244</IPString> <Country type="string">韩国</Country> <Area type="string"> </Area> <Address type="number">4108967635</Address> </item> </ResponseBody> </HttpResponse>
JSON响应
// Json响应
{
"Status" : 0,
"Messages" : [],
"ResponseBody" : [{
"IPString" : "192.168.1.1",
"Country" : "局域网",
"Area" : "对方和您在同一内部网",
"Address" : 16885952
}, {
"IPString" : "202.104.228.23",
"Country" : "广东省揭阳市",
"Area" : "(棉湖)电信ADSL",
"Address" : 400845002
}, {
"IPString" : "10.3.45.20",
"Country" : "局域网",
"Area" : "对方和您在同一内部网",
"Address" : 338494218
}, {
"IPString" : "8.8.8.8",
"Country" : "美国",
"Area" : "加利福尼亚州山景市谷歌公司DNS服务器",
"Address" : 134744072
}, {
"IPString" : "8.8.4.4",
"Country" : "美国",
"Area" : "加利福尼亚州山景市谷歌公司DNS服务器",
"Address" : 67373064
}, {
"IPString" : "211.222.233.244",
"Country" : "韩国",
"Area" : "",
"Address" : 4108967635
}]
}
JSOP响应
// JsonP响应
jsoncallback({
"Status" : 0,
"Messages" : [],
"ResponseBody" : [{
"IPString" : "192.168.1.1",
"Country" : "局域网",
"Area" : "对方和您在同一内部网",
"Address" : 16885952
}, {
"IPString" : "202.104.228.23",
"Country" : "广东省揭阳市",
"Area" : "(棉湖)电信ADSL",
"Address" : 400845002
}, {
"IPString" : "10.3.45.20",
"Country" : "局域网",
"Area" : "对方和您在同一内部网",
"Address" : 338494218
}, {
"IPString" : "8.8.8.8",
"Country" : "美国",
"Area" : "加利福尼亚州山景市谷歌公司DNS服务器",
"Address" : 134744072
}, {
"IPString" : "8.8.4.4",
"Country" : "美国",
"Area" : "加利福尼亚州山景市谷歌公司DNS服务器",
"Address" : 67373064
}, {
"IPString" : "211.222.233.244",
"Country" : "韩国",
"Area" : "",
"Address" : 4108967635
}]
});