本文为您介绍了号码归属查询的功能概述、产品优势、应用场景、产品定价、快速入门,API参考以及错误码等信息,帮助您快速了解并掌握号码归属查询的使用方式。

功能概述

与中国信息通信研究院系统实时互通,提供三网实时、准确、可靠的手机号码归属地、服务运营商查询功能,包含手机号码所属运营商、所属省份、所属城市等信息,准确识别携号转网、新网号、移动H相关信息,解决当前携号转网、新网号等用户行业短信收发、充值、注册等问题。

产品优势

该功能有以下两点优势:

全面准确

  • 覆盖三大运营商手机号。
  • 与中国信息通信研究院系统实时互通,准确识别携号转网、新网号。

快速接入

  • 提供API/SDK方式简易接入,登录即可一键开通。

应用场景

话费充值

话费充值应用查询手机号码当前服务运营商,避免错误或未知运营商信息导致充值失败的问题,降低充值失败率。

短信发送

短信发送平台查询手机号码当前服务运营商选择合适的发送通道,避免非当前服务运营商通道导致的发送失败和上行短信无法接收问题。

产品定价

号码归属查询根据用量次数进行计费。

计费规则

接口查询成功则计费,查询失败或者无结果不计费。即查询接口返回码为成功(Code="OK")时计费。

按量付费

按查询成功次数计费,标准价0.02元/次。

快速入门

第一步:注册阿里云账号

注册阿里云账号,完成企业实名认证,完成企业支付宝绑定。

1.阿里云注册入口:注册页面

2.实名认证:进行实名认证

3.绑定企业支付宝:绑定企业支付宝

第二步:开启功能

进入控制台在功能开启页操作开启。

号码查询

第三步:快速学习

左侧导航栏单击快速学习进入,了解和体验功能。

快速学习

第四步:获取阿里云访问密钥

阿里云访问密钥是阿里云为用户提供的访问各类云服务API而设计的“安全口令”。用它来签名 API 请求内容以通过服务端的安全验证。

1.创建AccessKey: 创建AccessKey

2.获取Access Key ID和Access Key Secret:查看Access Key ID和Access Key Secret

第五步:开发接入

详情参考下文。

API参考

在调用API时,您可以参见如下文档:

QueryPhoneNumberAttribute

调用QueryPhoneNumberAttribute获取号码当前服务运营商和归属地。

QueryPhoneNumberAttribute接口是号码归属地查询接口,支持在一次请求中获取一个号码当前服务运营商和归属地。

调用该接口获取号码归属地时,请注意:该请求会根据发送量计费,价格请参考计费说明。

调试您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryPhoneNumberAttribute

系统规定参数。取值:QueryPhoneNumberAttribute。

PhoneNumber String 1511***5678

要查询的手机号码。

返回数据

名称 类型 示例值 描述
RequestId String CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47

请求ID。

Code String OK

请求状态码。

Message String OK

状态码的描述。

PhoneNumberAttribute Struct

号码归属地。

Carrier String 中国移动

对外运营商。

Province String 浙江

省份。

City String 杭州

城市。

BasicCarrier String 中国移动

基础运营商。

IsNumberPortability Boolean false

是否携号转网。

NumberSegment Long 1511234

号段。

请求

请求示例

http(s)://dytnsapi.aliyuncs.com/?Action=QueryPhoneNumberAttribute
&PhoneNumber=15112345678
&<公共请求参数>

正常返回示例

XML 格式

<QueryPhoneNumberAttributeResponse>
<Code>200</Code>
<Message>200</Message>
<RequestId>CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47</RequestId>
<PhoneNumberAttribute>
    <BasicCarrier>中国移动</BasicCarrier>
    <Carrier>中国移动</Carrier>
    <City>杭州</City>
    <IsNumberPortability>false</IsNumberPortability>
    <NumberSegment>1511234</NumberSegment>
    <Province>浙江</Province>
</PhoneNumberAttribute>
</QueryPhoneNumberAttributeResponse>

JSON 格式

{
    "Code":"200",
    "Message":"200",
    "RequestId":"CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47",
    "PhoneNumberAttribute":{
        "BasicCarrier":"中国移动",
        "Carrier":"中国移动",
        "City":"杭州",
        "IsNumberPortability":false,
        "NumberSegment":"1511234",
        "Province":"浙江"
    }
}

错误码

访问错误中心查看更多错误码。

访问错误中心查看更多错误码。