调用DescribePhoneNumberResale接口验证号码是否为二次放号。
使用说明
本接口用于验证号码是否为二次放号。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
授权信息
默认仅限阿里云账号使用本接口,RAM用户只有在被授予了相关API操作权限后方可使用。具体请参见RAM用户权限。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribePhoneNumberResale |
系统规定参数。取值:DescribePhoneNumberResale。 |
PhoneNumber | String | 是 | 13088888**** |
手机号。 |
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-B38165CE**** |
请求ID。 |
TwiceTelVerify | Object |
二次放号校验。 |
|
Carrier | String | CMCC |
运营商。取值:
|
VerifyResult | Integer | 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:不支持携号转网的号码查询。 |
不支持携号转网的号码查询。 |
建议更换其他号码查询。携号转网的号码在原运营商侧已销户,新运营商侧认为携入的时间为开户时间,因此携号转网的号码无法准确的查询到该号码的真实情况。 |
示例
请求示例
http(s)://dytnsapi.aliyuncs.com/?Action=DescribePhoneNumberResale
&PhoneNumber=13088888****
&Since=2018-01-01 12:00:00
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribePhoneNumberResaleResponse>
<Code>OK</Code>
<Message>OK</Message>
<RequestId>CC3BB6D2-2FDF-4321-9DCE-B38165CE****</RequestId>
<TwiceTelVerify>
<Carrier>CMCC</Carrier>
<VerifyResult>0</VerifyResult>
</TwiceTelVerify>
</DescribePhoneNumberResaleResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Code" : "OK",
"Message" : "OK",
"RequestId" : "CC3BB6D2-2FDF-4321-9DCE-B38165CE****",
"TwiceTelVerify" : {
"Carrier" : "CMCC",
"VerifyResult" : 0
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Ram.CheckFailed | You did not pass the RAM permission check. | RAM权限校验失败 |
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 | System.LimitControl | The system is under flow control. | 系统限流控制 |
400 | OutOfService | The ISV is out of service. | 业务已停机 |
400 | Product.NotOrdered | You have not ordered this product (offer). | 未订购该产品 |
访问错误中心查看更多错误码。