一个免费的API-手机号码归属地接口

手机号码归属地接口:根据手机号码或手机号码的前7位,查询手机号码归属地信息,包括省份 、城市、区号、邮编、运营商和卡类型。

接口文档:https://www.juhe.cn/docs/api/id/11

如要使用,则需要先申请APPKEY,通过审核,之后就可以无限次免费使用。

1.API

接口地址:http://apis.juhe.cn/mobile/get
支持格式:json/xml
请求方式:get
请求示例:http://apis.juhe.cn/mobile/get?phone=13429667914&key=您申请的KEY
调用样例及调试工具:API测试工具
请求参数说明:
 名称类型必填说明
  phone int 需要查询的手机号码或手机号码前7位
  key string 应用APPKEY(应用详细页查询)
  dtype string 返回数据的格式,xml或json,默认json
返回参数说明:
 名称类型说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
  province string 省份
  city string 城市
  areacode string 区号
  zip string 邮编
  company string 运营商
  card string 卡类型
JSON返回示例:
{
"resultcode":"200",
"reason":"Return Successd!",
"result":{
    "province":"浙江",
    "city":"杭州",
    "areacode":"0571",
    "zip":"310000",
    "company":"中国移动",
    "card":"移动动感地带卡"
}
}

XML返回示例:

  <?xml version="1.0" encoding="utf-8" ?> 
- <root>
      <resultcode>200</resultcode> 
      <reason>Return Successd!</reason> 
    - <result>
          <province>浙江</province> 
          <city>杭州</city> 
          <areacode>0571</areacode> 
          <zip>310000</zip> 
          <company>中国移动</company> 
          <card>移动动感地带卡</card> 
      </result>
  </root>

2.错误码参照

服务级错误码参照(error_code):
 错误码说明
  201101 手机号码不能为空
  201102 错误的手机号码
  201103 查询无结果
系统级错误码参照:
 错误码说明旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121
错误码格式说明(示例:200201):
 200201
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

3.代码示例

posted @ 2016-11-08 13:53  annie123  阅读(13561)  评论(2编辑  收藏  举报