电话号码查询

国内率先完整提供 Demo 代码示例及数据专业且全面的 API 查询接口。
打造精品数据 API 品质，腾讯云提供计算服务及亿百天技术提供技术支持。
注册本站会员，即可免费使用！

电话号码查询

目录

接口使用

我要查询

提示：请在下面的 Demo 中输入您要查询的数据，点击查询即可。

电话号码查询

查询说明

支持查询：
1）热线号码：如 12345、95588、400 等各类服务/举报/客服热线，整号精确匹配；
2）手机号码：中国大陆 11 位手机号码，按号段前 7 位匹配归属地及运营商；
3）座机号码 / 港澳台号码：按长途区号匹配归属地（支持 0755-88888888、01012345678、00886-123456789 等输入格式）。

接口描述

功能描述

输入任意电话号码，自动识别其类型（热线号码 / 手机号码 / 座机号码 / 港澳台号码），并返回对应的机构信息或归属地信息。

URL 示例

1）http 协议：

POST 方式请求：

http://cha.ebaitian.cn/api/json?appid=xxx&module=getPhoneInfo&phone=xxx&sign=xxx

GET 方式请求：

http://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getPhoneInfo&phone=xxx&sign=xxx

2）https 协议：

POST 方式请求：

https://cha.ebaitian.cn/api/json?appid=xxx&module=getPhoneInfo&phone=xxx&sign=xxx

GET 方式请求：

https://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getPhoneInfo&phone=xxx&sign=xxx

请求参数

数据包体

{
    "type": "get",
    "appid": "1000xxxx",
    "module": "getPhoneInfo",
    "phone": "18062621234",
    "sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4"
}

参数说明

参数 必选 类型 描述
type 否 string 授权接口的请求方式
appid 是 string 授权接口的 AppID，请填写您在我要查官网上申请到的 AppID
module 是 string 目标请求的数据模块，查询电话号码为：getPhoneInfo
phone 是 string 目标要查询的电话号码（热线号码 / 中国大陆手机号码 / 座机号码 / 港澳台号码）
sign 是 string 请求凭证，具体计算方式见下面的其他说明

其他说明

1）type：可选值 get，如果赋值 get，则以 get 方式提交数据；默认以 post 方式提交数据；
2）sign：签名校验，根据公式 $sign=sha256(appid=$appid&module=getPhoneInfo&phone=$phone&appkey=$appkey) 生成；其中：appkey 为授权接口的 AppKey，请填写您在我要查官网上申请到的 AppKey 。

构造伪代码如下：

string type = "get"; //请求方式，可以赋值为：post
string appid = "1000xxxx"; //sdkappid 对应的 appid，需要业务方高度保密
string module = "getPhoneInfo"; //请求的数据模块，此处赋值：getPhoneInfo
string phone = "18062621234"; //要查询的电话号码
string sign = sha256(appid=1000xxxx&module=getPhoneInfo&phone=18062621234&appkey=56cf61af4b7897e704f67deb88ae8f24);

响应参数

数据包体

{
    "result":1,
    "description":"TRUE",
    "flag":"",
    "phonetype":"mobile",
    "phoneInfo":{
        "province":"湖北",
        "city":"武汉",
        "operator":"中国电信",
        "areacode":"027",
        "zipcode":"430000",
        "address":"湖北武汉 电信",
        "category":"",
        "orgname":"",
        "number":"18062621234",
        "remark":""
    }
}

参数说明

参数 必选 类型 描述
result 是 string 接口响应结果：0-失败；1-成功
description 是 string 接口响应描述：一般为 TURE（result=1） 与 FALSE（result=0），或者返回错误信息
flag 否 string 错误说明，没有错误则返回空
phonetype 是 string 号码类型：hotline-热线号码；mobile-手机号码；tel-座机/港澳台号码
phoneInfo 是 object 返回电话号码信息

phoneInfo 参数说明：

参数 必选 类型 描述
address 是 string 展示结果：热线返回机构/企业名；手机返回归属地+运营商（如 湖北武汉 电信）；座机/港澳台返回归属地（如 中国香港）
province 是 string 省份（手机/座机）；热线为空
city 是 string 城市/地区（手机/座机）；热线为空
operator 是 string 电信运营商（手机号）；其余为空
areacode 是 string 区号（手机归属区号 / 座机区号）
zipcode 是 string 邮政编码（手机号）
category 是 string 分类（热线号码）
orgname 是 string 机构/企业（热线号码）
number 是 string 查询的电话号码
remark 是 string 备注（热线号码）

SDK 及代码示例

PHP SDK

方法一：以 POST 方式请求数据

//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';

//函数，以POST方式提交数据，PHP需要开启CURL函数；数据传输安全，建议使用
function getPhoneInfo($phone){
    global $api_url,$api_appid,$api_appkey;
    $posturl=$api_url;
    $data='appid='.$api_appid.'&module=getPhoneInfo&phone='.$phone;
    $sign=hash("sha256",$data.'&appkey='.$api_appkey);
    $postdata=array("appid"=>$api_appid,"appkey"=>$api_appkey,"module"=>"getPhoneInfo","phone"=>$phone,'sign'=>$sign);
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $posturl);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);
    $output = curl_exec($curl);
    curl_close($curl);
    $obj=json_decode($output);
    $result=$obj->result;
    if($result==1){
        $value=$obj->phoneInfo->address;
    }else{
        $value=$obj->flag;
    }
    return $value;
}
//调用函数
$phone='18062621234';
echo getPhoneInfo($phone);
exit;

方法二：以 GET 方式请求数据

//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';

//函数，以GET方式提交数据
function getPhoneInfo($phone){
    global $api_url,$api_appid,$api_appkey;
    $data='appid='.$api_appid.'&module=getPhoneInfo&phone='.$phone;
    $sign=hash("sha256",$data.'&appkey='.$api_appkey);
    $info_get=file_get_contents($api_url.'?type=get&'.$data.'&sign='.$sign);
    $info_json=json_decode($info_get, true);
    $result=$info_json['result'];
    if($result==1){
        $value=$info_json['phoneInfo']['address'];
    }else{
        $value=$info_json['flag'];
    }
    return $value;
}
//调用函数
$phone='18062621234';
echo getPhoneInfo($phone);
exit;

其他语言 SDK

Java / Python / Node.js / C# / JavaScript / ASP 等语言的调用方式与「手机号码查询」一致，仅需将 module=getMobileArea&mobile= 替换为 module=getPhoneInfo&phone= 即可，返回结构为 phoneInfo，可直接参考 手机号码查询 页面对应语言示例。

常见问题

API 接口参数为空

此错误返回 JSON 数据如下：

{
    "result":0,
    "description":"API接口参数为空",
    "flag":"appid:sign"
}

解决方法：
1）请检查 appid 及 sign 是否为空；
2）确保 appid 是从官网获取到正确的接口授权；
3）确保 sign 计算生成是正确的。

API 接口参数无效

此错误返回 JSON 数据如下：

{
    "result":0,
    "description":"API接口参数无效",
    "flag":"appid"
}

解决方法：
1）请检查 appid 是否正确；
2）确保 appid 是从官网获取到正确的接口授权。

API 接口授权已到期

此错误返回 JSON 数据如下：

{
    "result":0,
    "description":"API接口授权已到期",
    "flag":"end:2018-12-31 23:59:59"
}

解决方法：
1）请检查 appid 对应接口授权的期限是否过期；
2）如果接口授权过期，请到官网更新（免费用户直接更新，无需续费）或续费（针对商业付费用户）。

签名错误

此错误返回 JSON 数据如下：

{
    "result":0,
    "description":"签名错误",
    "flag":"getPhoneInfo->sign"
}

解决方法：
1）请检查 sign 签名计算是否正确；
2）签名 sign 根据公式 $sign=sha256(appid=$appid&module=getPhoneInfo&phone=$phone&appkey=$appkey) 生成；其中：appkey 为授权接口的 AppKey，请填写您在我要查官网上申请到的 AppKey 。

请求受限

此错误返回 JSON 数据如下：

{
    "result":0,
    "description":"请求受限",
    "flag":"getPhoneInfo->daylimit"
}

解决方法：
1）授权接口已超出当前接口产品请求的最大限制；
2）请根据实际使用需求升级您的接口产品。

其他问题

如果您遇到其他的问题，请用以下方式联系我们，我们将为您提供 API 技术对接帮助。

请直接添加 QQ 技术交流群寻求我们帮助。
我要查API技术对接群①：
群号：821884327
扫码加入我要查API技术对接群①：