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

功能概述

号码状态是通过信令检测技术,实时查询手机号码的当前在网状态,包括正常,空号,停机,节省大量人力物力资源。

产品优势

该服务具备的优势主要有以下几点:

  • 检测成功率高。
  • 检测的状态类型多。
  • 检测的用户骚扰感知优势高于传统。

产品定价

按查询成功次数收费,标准价0.1元/次。

快速入门

第一步,注册阿里云账号

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

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

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

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

第二步,开通服务

进入控制台在功能开启页进行操作,启动服务。

号码状态

第三步:快速学习

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

快速学习

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

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

1.创建AccessKey: 创建AccessKey

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

第五步:开发接入

详情参考下文。

API参考

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

DescribePhoneNumberStatus

调用DescribePhoneNumberStatus获取号码实时在网状态,例如正常、停机、空号状态。

调用该接口获取号码状态时,请注意:该请求会根据查询次数计费,价格请参考计费说明。

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

请求参数

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

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

PhoneNumber String 15112345678

要查询的手机号码。

返回数据

名称 类型 示例值 描述
Code String OK

请求状态码。

Message String OK

状态码的描述。

PhoneStatus Struct

号码状态。

Carrier String 中国移动

对外运营商。

SerialId String 1100000000000

请求流水号。

Status String NORMAL

手机号码状态:

NORMAL-正常。

SHUTDOWN-停机。

NOT_EXIST-空号。

RequestId String CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47

请求ID。

示例

请求示例

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

正常返回示例

XML 格式

<DescribePhoneNumberStatusResponse>
<PhoneStatus>
    <Status>NORMAL</Status>
    <Carrier>中国移动</Carrier>
    <SerialId>1100000000000</SerialId>
</PhoneStatus>
<RequestId>CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47</RequestId>
<Message>OK</Message>
<Code>OK</Code>
</DescribePhoneNumberStatusResponse>

JSON 格式

{
    "PhoneStatus": {
        "Status": "NORMAL",
        "Carrier": "中国移动",
        "SerialId": 1100000000000
    },
    "RequestId": "CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47",
    "Message": "OK",
    "Code": "OK"
}

错误码

HttpCode 错误码 错误信息 描述
400 Ram.PermissionDeny You are not authorized to perform the operation. 权限不足
400 Unknown.ResourceOwnerId The resource does not belong to the current user. 资源不属于当前用户
400 Product.Unsubscript You have not subscribed to the specified product. 未订阅该功能
400 InvalidParameter The specified parameter is invalid. 参数异常
400 InvalidParameter The specified mobile phone number is invalid. 非法号码
400 System.LimitControl The system is under flow control. 系统限流控制
400 OutOfService The ISV is out of service. 业务已停机
403 Permission.NotAuthorized You are not authorized to perform the operation. 您没有权限执行此操作
400 Insufficient.Balance You have an insufficient balance. 余额不足

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

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