免费手机号归属地查询API接口详细教程

{
  "code": 200,
  "haoduan": "1321993",
  "shengfen": "四川",
  "chengshi": "绵阳",
  "fuwushang": "中国联通",
  "quhao": "0816",
  "qhdm": "510700",
  "youbian": "621000"
}

{
  "code": 400,
  "msg": "通讯秘钥错误。"
}

<?php
// 配置您的API凭证和要查询的手机号
$id = "您的用户ID"; // 替换为您的真实ID
$key = "您的通讯秘钥"; // 替换为您的真实KEY
$phone = "13219931963"; // 要查询的手机号
// 拼接请求URL
$api_url = "https://cn.apihz.cn/api/ip/shouji.php?id=" . $id . "&key=" . $key . "&phone=" . $phone;
// 初始化cURL会话
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 将响应结果返回，而不是直接输出
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 跳过SSL证书验证（仅测试环境建议，生产环境应设为true）
// 执行请求并获取返回的JSON数据
$response = curl_exec($ch);
// 检查请求是否成功
if (curl_error($ch)) {
    die('cURL请求发生错误: ' . curl_error($ch));
}
// 关闭cURL资源
curl_close($ch);
// 将JSON字符串解析为PHP数组或对象
$data = json_decode($response, true); // 设置为true解析为关联数组
// 处理返回数据
if ($data['code'] == 200) {
    // 查询成功，打印结果
    echo "手机号: " . $phone . "<br>";
    echo "归属地: " . $data['shengfen'] . "省 " . $data['chengshi'] . "市<br>";
    echo "运营商: " . $data['fuwushang'] . "<br>";
    echo "区号: " . $data['quhao'] . "<br>";
    echo "邮编: " . $data['youbian'];
} else {
    // 查询失败，打印错误信息
    echo "查询失败，错误信息: " . $data['msg'];
}
?>

import requests
import json
# 配置您的API凭证和要查询的手机号
id = "您的用户ID"  # 替换为您的真实ID
key = "您的通讯秘钥"  # 替换为您的真实KEY
phone = "13219931963"  # 要查询的手机号
# 接口地址
api_url = "https://cn.apihz.cn/api/ip/shouji.php"
# 构建请求参数
params = {
    "id": id,
    "key": key,
    "phone": phone
}
try:
    # 发送GET请求
    response = requests.get(api_url, params=params)
    # 确保请求成功（状态码为200）
    response.raise_for_status()
    
    # 解析返回的JSON数据
    data = response.json()
    
    # 处理返回数据
    if data['code'] == 200:
        # 查询成功，打印结果
        print(f"手机号: {phone}")
        print(f"归属地: {data['shengfen']}省 {data['chengshi']}市")
        print(f"运营商: {data['fuwushang']}")
        print(f"区号: {data['quhao']}")
        print(f"邮编: {data['youbian']}")
    else:
        # 查询失败，打印错误信息
        print(f"查询失败，错误信息: {data['msg']}")
except requests.exceptions.RequestException as e:
    # 处理网络请求异常
    print(f"网络请求出错: {e}")
except json.JSONDecodeError as e:
    # 处理JSON解析异常
    print(f"解析返回数据出错: {e}")