手機號碼歸屬地接口:根據手機號碼或手機號碼的前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:
手機號碼歸屬地接口調用示例
C#:
手機號碼歸屬地接口調用示例
Go:
手機號碼歸屬地接口調用示例
JAVA:
手機號碼歸屬地接口調用示例
