IP/手机号归属地查询

1. IP归属地查询

GET/api/ip.php?ip={IP地址}

参数	类型	必填	说明
ip	string	否	要查询的IP地址，不传则查询当前请求者IP
apikey	string	否	API Key（支持 GET 参数或 Header `X-API-Key`）

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "ip": "8.8.8.8",
    "location": "美国-加利福尼亚州-山景城-Google",
    "source": "local"   // local=本地库, remote=远程接口
  }
}

2. 手机号归属地查询

GET/api/phone.php?phone={手机号}

参数	类型	必填	说明
phone	string	是	11位中国大陆手机号
apikey	string	否	API Key（支持 GET 参数或 Header `X-API-Key`）

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "phone": "13800138000",
    "prefix": "1380013",
    "province": "北京",
    "city": "北京",
    "carrier": "中国移动",
    "area_code": "010",
    "zip_code": "100000",
    "region_code": "110100",
    "location": "北京-北京中国移动"
  }
}

3. 错误码说明

code	HTTP状态码	说明
0	200	查询成功
400	400	参数错误（无效IP/手机号格式）
401	401	无效的 API Key
403	403	API Key 已被禁用
404	404	未查询到归属地信息
429	429	超出每日查询限额
500	500	服务器内部错误

💡 提示：API 接口支持匿名访问，但建议注册获取 API Key 以获得更高的查询限额和稳定性。
如需获取 API Key，请联系管理员开通客户账号。

使用方式：
• GET 参数：?apikey=YOUR_KEY
• 请求头：X-API-Key: YOUR_KEY

🔍 归属地查询

1. IP归属地查询

2. 手机号归属地查询

3. 错误码说明