编辑“预订宝/IP地址归属地查询系统”

{{预订宝导航}}
IP地址归属地查询系统基于著名的纯真IP数据库实现，预订宝提供该实用工具的API是因为IP查询系统实现简单，容易理解，适合开发者入门学习之用。

实际上，并不建议开发者使用该API来查询IP地址，如果生产环境需要此功能，应当在本地程序中自行实现查询效率更高、稳定性更好的功能。

==接口概述==
*'''接口地址：<nowiki>http://api.yudingbao.net/v1.0/generictools/ipsearcher.ashx</nowiki>
*'''说明：'''调用本接口可以查询IP地址的归属地信息。
*'''鉴权方式：'''本接口使用密钥标记鉴权，不严格要求调用者的身份。使用本接口需要申请实用工具授权。
*'''响应模式：'''[[JSON]]、[[JSONP]]、[[XML]]

==获取版本信息==
*'''调用方式：'''GET
*'''动作：'''getVersion
*'''参数：'''无

===示例代码===
请求示例
<pre>
<!--请求示例，该接口的访问类同于如下表单的提交，请留意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>
</pre>


XML响应
<pre>
<!--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>
</pre>


JSON响应
<pre>
// Json响应
{
    "Status" : 0,
    "Messages" : [],
    "ResponseBody" : {
        "FileName" : "QQWry.DAT",
        "Copyright" : "纯真网络",
        "UpdateTime" : Date(1304524800000),
        "RecordCount" : 424032
    }
}
</pre>


JSONP响应
<pre>
// JsonP响应
jsoncallback({
    "Status" : 0,
    "Messages" : [],
    "ResponseBody" : {
        "FileName" : "QQWry.DAT",
        "Copyright" : "纯真网络",
        "UpdateTime" : Date(1304524800000),
        "RecordCount" : 424032
    }
});
</pre>


==查询IP地址==
*'''调用方式：'''POST
*'''动作：'''query
*'''参数：'''见参数说明

===参数说明===
{|border="1" align="center" width="75%"
|-
! 参数名称|| 参数类型|| 说明
|-
| rowspan="2" | ipaddress
| rowspan="2" | array
| 一个数组。包含要查询的IP地址的字符串形式的集合。
|-
| 例如：[    '192.168.1.1', '215.216.12.34' ]
|}

===示例代码===
请求示例
<pre>
<!--请求示例，该接口的访问类同于如下表单的提交，请留意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>
</pre>


XML响应
<pre>
<!--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>
</pre>


JSON响应
<pre>
// 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
        }]
}
</pre>


JSOP响应
<pre>
// 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
        }]
});
</pre>




==参考来源==
*http://www.yudingbao.com/dev/generictools/ip-searcher.html


[[category:预订宝|I]]

{{预订宝使用手册导航}}