调用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)://[Endpoint]/?Action=DescribePhoneNumberResale
&PhoneNumber=13088****88
&Since=2018-01-01 12:00:00
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

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

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