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

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

说明 在使用接口前,请参见 公共参数调用方式等公共信息。

调试

您可以在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

请求状态码。取值:

  • OK:成功。
  • isv.INVALID_PARAMETERS:非法参数。
  • isv.MOBILE_NUMBER_ILLEGAL:手机号码格式错误。
  • isp.QPS_LIMIT:触发QPS限制。
  • isp.OPERATOR_LIMIT:运营商限制。
  • isp.UNKNOWN:未知异常。
  • isp.SYSTEM_ERROR:网元系统异常。
Message String OK

状态码的描述。

RequestId String CC3BB6D2-2FDF-4321-9DCE-B38165CE****

请求ID。

TwiceTelVerify Struct

二次放号校验。

Carrier String CMCC

运营商。取值:

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

查询结果。取值:

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

示例

请求示例

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

正常返回示例

XML格式

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

JSON格式

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

错误码

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

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