联系客服: iP138.com客服 iP138客服 |

iP无极4平台接口
  • API接口QQ交流群:177096428   iP138 api接口
  • 数据修正QQ处理群:94181690    iP138数据修正
  • iP无极4平台接口支持HTTPS(赠送1000次)

    简介:获取iP地址对应的省市区以及运营商名称

    已连接应用数:19069

    * API接口可能会因为各种网络原因和攻击都可能产生阻断,请开发时做好冗余和异常处理

    * 当HTTP请求返回的状态码非200时,请做异常处理,比如 202 状态码造成的原因可能是无效Token、余额不足、格式错误

    iP无极4平台接口文档说明

    接口地址

    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|echo|js(可选,默认为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|echo|js(可选,默认为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|echo|js(可选,默认为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无极4平台结果数据 为err时返回msg错误信息

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

    XML返回示例

    说明:ret 值为 ok 时 返回data无极4平台结果数据 为err时返回msg错误信息

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

    文本格式返回示例

    117.25.13.123 中国 福建 福州 电信 361000 0592
    

    echo格式返回示例

    <script type="text/javascript">document.write("<span class='ip_0'>117.25.13.123</span><span class='ip_1'>中国</span><span class='ip_2'>福建</span><span class='ip_3'>福州</span><span class='ip_4'>电信</span><span class='ip_5'>361000</span><span class='ip_6'>0592</span>");</script>

    js格式返回示例

    <script type="text/javascript">var ipInfo={ip:"117.25.13.123",country:"中国",region:"福建",city:"福州",isp:"电信",zip:"361000",zone:"0592"};</script>

    无极4平台token使用情况

    URL

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

    请求方式

    get

    参数

    1. token `string` ip无极4平台服务token

    示例

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

    响应

    {
        "ret":"ok",
        "data":{
            "reqs":10,   //当前小时请求数
            "hour":3000, //当前小时购买次数
            "package":19767 //备用次数
        }
    }