手机号码归属地接口:根据手机号码或手机号码的前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):
2 | 002 | 01 | |
---|---|---|---|
服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |
3.代码示例
PHP:手机号码归属地查询
Python:手机号码归属地接口调用示例
JAVA:手机号码归属地接口调用示例