手机号查询接口文档说明

接口地址

http协议：
国内大陆优化（支持ipv6）http://api.ipshudi.com/mobile/
国际各洲覆盖（部份ipv6）http://api.ip138.com/mobile/

https协议：
国内大陆优化（支持ipv6）https://api.ipshudi.com/mobile/
国际各洲覆盖（部份ipv6）https://api.ip138.com/mobile/

请求方式

get

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

参数说明:
1. mobile string 手机号码
2. datatype string txt|jsonp|xml（可选，默认为jsonp）
3. callback string 回调函数 当前参数仅为jsonp格式数据提供（可选，默认为空）
4. token string 购买服务后会提供（必填）

curl "https://api.ip138.com/mobile/?mobile=13600130000&datatype=jsonp&callback=find" -H "token:cc87f3c77747bccbaaee35006da1ebb65e0bad57"

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

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

https://api.ip138.com/mobile/?mobile=13600130000&callback=find&oid={oid}&mid={mid}&sign=签名算法

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

参数说明:
1. mobile string 手机号码
2. datatype string txt|jsonp|xml（可选，默认为jsonp）
3. callback string 回调函数 当前参数仅为jsonp格式数据提供（可选，默认为空）
4. token string 购买服务后会提供（必填）

https://api.ip138.com/mobile/?mobile=13209760000&datatype=jsonp&callback=find&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57

JSONP返回示例

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

{
    "ret": "ok",    // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    "mobile": "13209760000",  // 手机号
    "data": [
        "青海",     // 省份/自治区/直辖市
        "海西",     // 地级市
        "联通130卡",// 卡类型(暂不提供)
        "0977",    // 城市区号 
        "632800",  // 行政区划代码(暂不提供)
    ]
}

XML返回示例

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

<xmlinfo>
  <ret>ok</ret>
  <mobile>13209760000</mobile>
  <data>
   <province>青海</province>
   <city>海西</city>
   <card>联通130卡(暂不提供)</city>
   <zone>0977</zone>
   <cityCode>632800(暂不提供)</cityCode>
  </data>
</xmlinfo>

文本格式返回示例

13209760000 青海 海西 联通130卡(暂不提供) 0977 632800(暂不提供)

行政区划代码列表说明

点击下载

查询token使用情况

URL

https://api.ip138.com/status/

请求方式

get

参数

1. token `string`

示例

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

响应

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