手机号码归属地接口:根据手机号码或手机号码的前7位,查询手机号码归属地信息,包括省份 、城市、区号、邮编、运营商和卡类型。
如要使用,则需要先申请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返回示例:
-
200
Return Successd!
-
浙江
杭州
0571
310000
中国移动
移动动感地带卡
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.代码示例