验证手机号是否为运营商二次放号的号码，支持在一次请求中快速检验号码是否为二次放号。
接口说明
请确保在使用本接口前，您已充分了解号码百科产品定价。
当返回结果中：Code="OK" 且 VerifyResult != 0 时计费，其他情况不计费。
使用本接口前，请登录号码百科控制台，在标签广场页面，找到对应的标签，单击申请开通，填写申请资料，审批通过后即可使用。
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
授权信息
默认仅限阿里云账号使用本接口，RAM 用户只有在被授予了相关 API 操作权限后方可使用。具体请参见为 RAM 用户授权。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dytns:DescribePhoneTwiceTelVerify |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| AuthCode |
string |
是 |
授权码。 说明
在号码百科控制台我的申请页面，获取授权 ID 即授权码。 |
Dd1r***4id |
| InputNumber |
string |
是 |
待查询的号码。
重要 加密字符串中字母不区分大小写。 |
139******* |
| Mask |
string |
是 |
号码的加密方式。取值：
|
NORMAL |
| StartTime |
string |
是 |
时间，格式必须为 yyyy-MM-dd HH:mm:ss。该时间为手机用户在业务侧的注册时间。如果注册时间在运营商放号时间之后，则表示该号码不是二次号，否则返回结果是二次号。 说明
|
2018-01-01 00:00:00 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
结构体。 |
||
| RequestId |
string |
公共参数，每个请求返回的 ID 都是唯一的，可用于排查和定位问题。 |
68A40250-50CD-034C-B728-0BD135850177 |
| Code |
string |
请求状态码。取值：
说明
当 Code 取值为 OK，且 VerifyResult 值不为 0 时计费，计费文档请参见号码百科定价。 |
OK |
| Message |
string |
状态码的描述。 |
OK |
| Data |
object |
结构体。 |
|
| VerifyResult |
string |
查询结果。取值：
|
1 |
| Carrier |
string |
运营商。取值：
说明
返回当前号码的归属运营商，如果该号码存在携号转网的情况，则返回携号转网后的运营商。 |
CMCC |
状态码原因及解决方案
| HttpCode | 状态码 | 原因 | 解决方案 |
| 200 | OK：成功。 | 请求参数符合要求。 | 表示接口调用成功。 |
| 200 | PortabilityNumberNotSupported：不支持的携号转网号码。 | 部分携号转网号码会返回此错误码。 | 建议更换其他号码查询。携号转网的号码在原运营商侧已销户，新运营商侧认为携入的时间为开户时间，因此携号转网的号码无法准确的查询到该号码的真实情况。 |
| 200 | RequestNumberNotSupported：不支持查询的号码。 | 不支持中国广电号码（192 开头）、虚拟运营商、和其他运营商不支持查询的号码。 | 建议更换运营商支持查询的号码。 |
异常原因及解决方案
| HttpCode | 状态码 | 原因 | 解决方案 |
| 400 | AuthCodeNotExist：授权码不存在。 | 授权码不存在。 | 请先在号码分析服务申请您所需的标签，申请成功并获得授权码后，再发起接口调用。 |
| 400 | MobileNumberIllegal：请求参数的手机号格式有误。 | 手机号格式填写有误。 | 若手机号未加密，填入 11 位正确的数字号码即可；若手机号经 MD5 加密处理，该字段为 32 位加密字符串；若手机号经 SHA256 加密处理，该字段为 64 位加密字符串。 |
| 400 | MobileNumberTypeIllegal：加密方式类型错误。 | 不支持的加密方式或加密类型不规范。 | 加密方式仅支持 NORMAL、MD5、SHA256 三种，且必须为大写字符。 |
| 500 | Unknown：未知异常。 | 系统返回了未知异常。 | 请您尝试重新调用接口，建议重试的次数不要超过 3 次。 |
| 500 | SystemError：网元系统异常。 | 系统错误。 | 请尝试重新调用接口，建议重试次数不要超过 3 次。 |
示例
正常返回示例
JSON格式
{
"RequestId": "68A40250-50CD-034C-B728-0BD135850177",
"Code": "OK",
"Message": "OK",
"Data": {
"VerifyResult": "1",
"Carrier": "CMCC"
}
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 200 | PortabilityNumberNotSupported | 不支持2021年6月前携号转网的号码查询 | 不支持2021年6月前携号转网的号码查询 |
| 200 | RequestNumberNotSupported | 不支持中国广电号码（192开头）和虚拟运营商号码的查询 | 不支持中国广电号码（192开头）和虚拟运营商号码的查询 |
| 200 | RequestFrequencyLimit | 因运营商限制，禁止在短时间内高频对同一个号码进行反复查询 | 因运营商限制，禁止在短时间内高频对同一个号码进行反复查询 |
| 400 | Product.Unsubscript | You have not subscribed to the specified product. | 未订阅该功能 |
| 400 | Ram.PermissionDeny | You are not authorized to perform the operation. | 权限不足 |
| 400 | System.LimitControl | The system is under flow control. | 系统限流控制 |
| 400 | Unknown.ResourceOwnerId | The resource does not belong to the current user. | 资源不属于当前用户 |
| 400 | MobileNumberIllegal | Wrong format of phone number | 手机号码格式错误 |
| 400 | MobileNumberTypeNotMatch | Phone number and encryption type do not match | |
| 400 | InputParamIllegal | Wrong format of input parameter | 参数格式错误 |
| 400 | AuthCodeIllegal | Illegal authCode. | 鉴权时使用的authcode不可用于该接口 |
| 400 | ThresholdIllegal | Please fill in the threshold range from 0 to 100 correctly. | 请正确填写阈值范围0～100！ |
| 400 | AuthCodeNotExist | The label application form does not exist, please replace the authorization code. | 该标签申请单不存在，请重新更换授权码 |
| 400 | MobileNumberTypeIllegal | Invalid number type. | 号码类型错误 |
| 400 | TagNotExist | The label does not exist. | 标签不存在 |
| 400 | InvalidParameter | Invalid parameter. | 无效参数 |
| 500 | Unknown | Unknown error | 未知异常 |
| 500 | SystemError | System error | 系统异常 |
| 500 | RequestSupplierError | Request supplier error. | 请求第三方服务异常。 |
| 500 | RequestTimeout | Request supplier timed out. | 请求供应商超时 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。