本文为您介绍了二次号的背景信息、入门概述、API参考、错误码以及常见问题等信息,通过本文,您可以更加快速的了解二次号的使用。

背景信息

号码资源有限,运营商把号码回收冷冻后重新分配给新的用户使用,由于原用户未能及时解除该号码注册/绑定的互联网等行业应用,从而引发号码新用户使用有关服务受阻,导致用户投诉甚至发生经济纠纷。二次号查询快速查询是否二次放号,避免新旧机主纠纷,快速解决四大问题:新号主无法注册、旧号主信息泄露、服务信息误发、金融交易资金风险。

产品优势

二次号的产品优势有以下几点:

  • 覆盖三大运营商手机号。
  • 提供API/SDK方式简易接入,登陆即可一键开通。

应用场景

应用注册和登陆判断

  • 新机主注册应用提示已被注册。
  • 新机主通过短信验证码登陆旧机主账号。
  • 旧机主无法通过手机号码验证找回账号信息。

金融交易风控

互联网金融,银行,证券,保险等交易前判断,避免由于二次放号导致的资金盗用。

产品定价

二次放号校验服务采用预先充值、按量付费的付费模式。根据校验成功次数实时扣费。

说明 实时计费,自动跨档,跨档后当月所有发送量按新阶梯价重新计算。
二次放号校验使用量阶梯(次/月) 运营商 价格(元/次)
量≤5万 电信 0.40
联通 0.40
移动 0.60
5万<量≤10万 电信 0.35
联通 0.35
移动 0.55
10万<量≤30万 电信 0.30
联通 0.30
移动 0.50
量>30万 电信 0.25
联通 0.25
移动 0.45

快速入门

第一步:注册阿里云账号

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

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

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

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

第二步:快速学习

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

快速学习

第三步:开启功能

进入控制台在功能开启页操作开启。至少需要开启一个功能方可正常使用。您可以根据使用需要选择开启号码归属查询或者二次号查询或者号码状态查询中的任意一个或者几个。

二次号控制台

点击按钮之后,您需要同意本产品的服务协议,才能使用该功能。

同意

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

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

1.创建AccessKey: 创建AccessKey

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

第五步:开发接入

详情参考下文。

API 参考

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

DescribePhoneNumberResale

调用DescribePhoneNumberResale验证号码是否为二次放号。

DescribePhoneNumberResale是二次放号验证接口,支持在一次请求中快速检验号码是否为二次放号。调用该接口验证号码时,请注意:价格请参考报价说明。

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

请求参数
名称 类型 是否必选 示例值 描述
Action String DescribePhoneNumberResale

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

PhoneNumber String 1308****8888

手机号。

Since String 2018-01-01 12:00:00

时间,格式必须为yyyy-MM-dd HH:mm:ss。查询接口返回的是该时间点后号码是否有二次放号行为。

返回数据
名称 类型 示例值 描述
Code String OK

请求状态码。

Message String OK

状态码的描述。

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

请求ID。

TwiceTelVerify Struct

二次放号校验。

Carrier String CMCC

运营商。

  • CMCC:中国移动。
  • CUCC:中国联通。
  • CTCC:中国电信。
VerifyResult Integer 0

查询结果。

  • 0:无法判断。
  • 1:是二次放号。
  • 2:不是二次放号。
  • 3:号码已销号。
示例

请求示例

http(s)://dytnsapi.aliyuncs.com/?Action=DescribePhoneNumberResale
&PhoneNumber=13088****88
&Since=2018-01-01 12:00:00
&<公共请求参数>

正常返回示例

XML 格式

<DescribePhoneNumberResaleResponse>
<RequestId>CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47</RequestId>
<Message>OK</Message>
<TwiceTelVerify>
    <Carrier>CMCC</Carrier>
    <VerifyResult>0</VerifyResult>
</TwiceTelVerify>
<Code>OK</Code>
</DescribePhoneNumberResaleResponse>

JSON 格式

{
    "RequestId": "CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47",
    "Message": "OK",
    "TwiceTelVerify": {
        "Carrier": "CMCC",
        "VerifyResult": 0
    },
    "Code": "OK"
}

错误码

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

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