手机号码归属地接口：根据手机号码或手机号码的前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.错误码参照
| 错误码 | 说明 |
|---|---|
| 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：手机号码归属地接口调用示例
C#：手机号码归属地接口调用示例
Go：手机号码归属地接口调用示例
JAVA：手机号码归属地接口调用示例
