项目进展

http://write.blog.csdn.net/postedit

iP接口文档说明

接口地址

http协议：http://api.ip138.com/query/
https协议：https://api.ip138.com/query/

请求方式

get

示例1（Linux命令行下执行）

参数说明:
1. ip string ip地址 例如 117.25.13.123（可选，默认为请求者ip）
2. datatype string txt|jsonp|xml（可选，默认为jsonp）
3. callback string 回调函数 当前参数仅为jsonp格式数据提供（可选，默认为空）
4. token string 购买服务后会提供（必填）

curl "http://api.ip138.com/query/?ip=8.8.8.8&datatype=jsonp&callback=find" -H "token:cc87f3c77747bccbaaee35006da1ebb65e0bad57"
                        

示例2（js引入推荐方案）

参数说明:
1. ip string ip地址 例如 117.25.13.123（可选，默认为请求者ip）
2. datatype string txt|jsonp|xml（可选，默认为jsonp）
3. callback string 回调函数 当前参数仅为jsonp格式数据提供（可选，默认为空）
4. sign string 签名验证 签名算法:md5("ip=" + ip + "&token=" + token)（必填）
5. oid string 购买服务后提供（必填）
6. mid string 购买服务后提供（必填）

http://api.ip138.com/query/?ip=8.8.8.8&callback=find&oid={oid}&mid={mid}&sign=签名算法
                        

示例3（为了您的token安全，请勿使用于js引入，js引入请参考示例2）

参数说明:
1. ip string ip地址 例如 117.25.13.123（可选，默认为请求者ip）
2. datatype string txt|jsonp|xml（可选，默认为jsonp）
3. callback string 回调函数 当前参数仅为jsonp格式数据提供（可选，默认为空）
4. token string 购买服务后会提供（必填）

http://api.ip138.com/query/?ip=8.8.8.8&datatype=jsonp&callback=find&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57
                        

JSONP返回示例

说明：ret 值为 ok 时 返回data查询结果数据 为err时返回msg错误信息

{
    "ret": "ok",    // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    "ip": "117.25.13.123",  // ip
    "data": [
        "中国",     // 国家
        "福建",     // 省会或直辖市
        "福州",     // 地区或城市
        "电信",     // 运营商
    ]
}
                        

XML返回示例

说明：ret 值为 ok 时 返回data查询结果数据 为err时返回msg错误信息

<xmlinfo>
  <ret>ok</ret>
  <ip>117.25.13.123</ip>
  <data>
   <country>中国</country>
   <region>福建</region>
   <city>福州</city>
   <isp>电信</isp>
  </data>
</xmlinfo>
                        

文本格式返回示例

117.25.13.123 中国 福建 福州 电信
                        

查询token使用情况

URL

http://api.ip138.com/status/

请求方式

get

参数

1. token `string` ip查询服务token

示例

http://api.ip138.com/status/?token=cc87f3c77747bccbaaee35006da1ebb65e0bad57
                        

响应

{
    "ret":"ok",
    "data":{
        "reqs":10,
        "hour":3000,
        "package":19767
    }
}