阿里云首页 号码百科

DescribePhoneNumberResale - 验证号码是否为二次放号

调用DescribePhoneNumberResale接口验证号码是否为二次放号。DescribePhoneNumberResale是二次放号验证接口,支持在一次请求中快速检验号码是否为二次放号。

使用说明

本接口用于验证号码是否为二次放号。发起调用该接口验证号码请求时,系统会根据验证次数计费,详情请参见二次号查询定价

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

授权信息

默认仅限阿里云账号使用本接口,RAM用户只有在被授予了相关API操作权限后方可使用。具体请参见为RAM用户授权

调试

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

调试

授权信息

当前API暂无授权信息透出

请求参数

名称类型必填描述示例值
PhoneNumberstring

手机号。

13088888****
Sincestring

时间,格式必须为yyyy-MM-dd HH:mm:ss。查询接口返回的是在该时间点前,该号码是否在运营商侧有过二次放号的行为。如果该时间点在最后一次放号(除初次放号外)的时间点后,则返回结果为“是二次放号”。

2018-01-01 12:00:00

返回参数

名称类型描述示例值
object

结构体。

Codestring

请求状态码。取值:

  • OK:成功。
  • isv.INVALID_PARAMETERS:非法参数。
  • isv.MOBILE_NUMBER_ILLEGAL:手机号码格式错误。
  • isp.QPS_LIMIT:触发QPS限制。
  • isp.OPERATOR_LIMIT:运营商限制。
  • isp.UNKNOWN:未知异常。
  • isp.SYSTEM_ERROR:网元系统异常。
  • isp.PORTABILITY_NUMBER_NOT_SUPPORTED:不支持2021年6月前携号转网的号码查询。
说明请求状态码详情请参见下表:状态码原因及解决方案。
OK
Messagestring

状态码的描述。

OK
RequestIdstring

请求ID。

CC3BB6D2-2FDF-4321-9DCE-B38165CE****
TwiceTelVerifyobject

二次放号校验。

Carrierstring

运营商。取值:

  • CMCC:中国移动。

  • CUCC:中国联通。

  • CTCC:中国电信。

CMCC
VerifyResultinteger

查询结果。取值:

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

状态码原因及解决方案

状态码原因解决方案
OK:成功。请求参数符合要求。表示接口调用成功。
isv.INVALID_PARAMETERS:非法参数。请求参数不符合API接口的要求。调整请求参数的格式,再重新提交请求。例如:删除请求参数中的不可见字符、空格、调整为半角字符等。
isv.MOBILE_NUMBER_ILLEGAL:手机号码格式错误。请求参数的手机号格式错误。输入正确的手机号,再重新提交请求。如:删除手机号中的不可见字符、空格、调整为半角字符等。若手机号格式正确仍出现该错误码,请通过工单联系工程师处理。
isp.QPS_LIMIT:触发QPS限制。当前查询频率已达系统上限。请将查询频率限制在正常范围内,对于出现该错误码的号码适当进行重查,建议重复查询的次数不要超过3次。若的确有大并发的场景和需求,请创建工单联系工程师处理。
isp.OPERATOR_LIMIT:运营商限制。该号码运营商侧禁止查询或查询不出结果。请重试或使用其它号码查询。建议重复查询的次数不要超过3次。
isp.UNKNOWN:未知异常。系统返回了未知异常。请尝试重新调用接口,建议重试的次数不要超过3次。如仍存在此异常,请通过工单反馈至工程师处理。
isp.SYSTEM_ERROR:网元系统异常。系统错误。请尝试重新调用接口,建议重试的次数不要超过3次。如仍存在此异常,请通过工单反馈至工程师处理。
isp.PORTABILITY_NUMBER_NOT_SUPPORTED:不支持2021年6月前携号转网的号码查询。查询2021年6月前携号转网的号码会返回此错误码,但查询2021年6月后携号转网的号码可返回是否是二次号的查询结果。建议更换其他号码查询。携号转网的号码在原运营商侧已销户,新运营商侧认为携入的时间为开户时间,因此携号转网的号码无法准确的查询到该号码的真实情况。

示例

请求示例

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

正常返回示例

JSON格式

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

XML格式

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

错误码

HttpCode错误码错误信息描述
400Ram.CheckFailedYou did not pass the RAM permission check.RAM权限校验失败
400Ram.PermissionDenyYou are not authorized to perform the operation.权限不足
400Unknown.ResourceOwnerIdThe resource does not belong to the current user.资源不属于当前用户
400Product.UnsubscriptYou have not subscribed to the specified product.未订阅该功能
400System.LimitControlThe system is under flow control.系统限流控制
400OutOfServiceThe ISV is out of service.业务已停机
400Product.NotOrderedYou have not ordered this product (offer).未订购该产品

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

首页 号码百科 API参考指南 API目录 验证 DescribePhoneNumberResale - 验证号码是否为二次放号