驗(yàn)證手機(jī)號是否為運(yùn)營商二次放號的號碼，支持在一次請求中快速檢驗(yàn)號碼是否為二次放號。
接口說明
- 請確保在使用本接口前，您已充分了解號碼百科產(chǎn)品定價。
- 當(dāng)返回結(jié)果中：Code="OK" 且 VerifyResult != 0 時計(jì)費(fèi)，其他情況不計(jì)費(fèi)。
- 使用本接口前，請登錄號碼百科控制臺，在標(biāo)簽廣場頁面，找到對應(yīng)的標(biāo)簽，單擊申請開通，填寫申請資料，審批通過后即可使用。
QPS 限制
本接口的單用戶 QPS 限制為 100 次/秒。超過限制，API 調(diào)用會被限流，這可能會影響您的業(yè)務(wù)，請合理調(diào)用。
授權(quán)信息
默認(rèn)僅限阿里云賬號使用本接口，RAM 用戶只有在被授予了相關(guān) API 操作權(quán)限后方可使用。具體請參見為 RAM 用戶授權(quán)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
當(dāng)前API暫無授權(quán)信息透出。
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| AuthCode | string | 是 | 授權(quán)碼。 說明
在號碼百科控制臺我的申請頁面，獲取授權(quán) ID 即授權(quán)碼。
| Dd1r***4id |
| InputNumber | string | 是 | 待查詢的號碼。
注意 加密字符串中字母不區(qū)分大小寫。 | 139******* |
| Mask | string | 是 | 號碼的加密方式。取值：
| NORMAL |
| StartTime | string | 是 | 時間，格式必須為 yyyy-MM-dd HH:mm:ss。該時間為手機(jī)用戶在業(yè)務(wù)側(cè)的注冊時間。如果注冊時間在運(yùn)營商放號時間之后，則表示該號碼不是二次號，否則返回結(jié)果是二次號。 說明
| 2018-01-01 00:00:00 |
返回參數(shù)
狀態(tài)碼原因及解決方案
| HttpCode | 狀態(tài)碼 | 原因 | 解決方案 |
|---|---|---|---|
| 200 | OK：成功。 | 請求參數(shù)符合要求。 | 表示接口調(diào)用成功。 |
| 200 | PortabilityNumberNotSupported：不支持的攜號轉(zhuǎn)網(wǎng)號碼。 | 部分?jǐn)y號轉(zhuǎn)網(wǎng)號碼會返回此錯誤碼。 | 建議更換其他號碼查詢。攜號轉(zhuǎn)網(wǎng)的號碼在原運(yùn)營商側(cè)已銷戶，新運(yùn)營商側(cè)認(rèn)為攜入的時間為開戶時間，因此攜號轉(zhuǎn)網(wǎng)的號碼無法準(zhǔn)確的查詢到該號碼的真實(shí)情況。 |
| 200 | RequestNumberNotSupported：不支持查詢的號碼。 | 不支持中國廣電號碼（192 開頭）、虛擬運(yùn)營商、和其他運(yùn)營商不支持查詢的號碼。 | 建議更換運(yùn)營商支持查詢的號碼。 |
異常原因及解決方案
| HttpCode | 狀態(tài)碼 | 原因 | 解決方案 |
|---|---|---|---|
| 400 | AuthCodeNotExist：授權(quán)碼不存在。 | 授權(quán)碼不存在。 | 請先在號碼分析服務(wù)申請您所需的標(biāo)簽，申請成功并獲得授權(quán)碼后，再發(fā)起接口調(diào)用。 |
| 400 | MobileNumberIllegal：請求參數(shù)的手機(jī)號格式有誤。 | 手機(jī)號格式填寫有誤。 | 若手機(jī)號未加密，填入 11 位正確的數(shù)字號碼即可；若手機(jī)號經(jīng) MD5 加密處理，該字段為 32 位加密字符串；若手機(jī)號經(jīng) SHA256 加密處理，該字段為 64 位加密字符串。 |
| 400 | MobileNumberTypeIllegal：加密方式類型錯誤。 | 不支持的加密方式或加密類型不規(guī)范。 | 加密方式僅支持 NORMAL、MD5、SHA256 三種，且必須為大寫字符。 |
| 500 | Unknown：未知異常。 | 系統(tǒng)返回了未知異常。 | 請您嘗試重新調(diào)用接口，建議重試的次數(shù)不要超過 3 次。 |
| 500 | SystemError：網(wǎng)元系統(tǒng)異常。 | 系統(tǒng)錯誤。 | 請嘗試重新調(diào)用接口，建議重試次數(shù)不要超過 3 次。 |
示例
正常返回示例
JSON格式
{
"RequestId": "68A40250-50CD-034C-B728-0BD135850177",
"Code": "OK",
"Message": "OK",
"Data": {
"VerifyResult": "1",
"Carrier": "CMCC"
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 200 | PortabilityNumberNotSupported | 不支持2021年6月前攜號轉(zhuǎn)網(wǎng)的號碼查詢 | 不支持2021年6月前攜號轉(zhuǎn)網(wǎng)的號碼查詢 |
| 200 | RequestNumberNotSupported | 不支持中國廣電號碼（192開頭）和虛擬運(yùn)營商號碼的查詢 | 不支持中國廣電號碼（192開頭）和虛擬運(yùn)營商號碼的查詢 |
| 200 | RequestFrequencyLimit | 因運(yùn)營商限制，禁止在短時間內(nèi)高頻對同一個號碼進(jìn)行反復(fù)查詢 | 因運(yùn)營商限制，禁止在短時間內(nèi)高頻對同一個號碼進(jìn)行反復(fù)查詢 |
| 400 | Product.Unsubscript | You have not subscribed to the specified product. | 未訂閱該功能 |
| 400 | Ram.PermissionDeny | You are not authorized to perform the operation. | 權(quán)限不足 |
| 400 | System.LimitControl | The system is under flow control. | 系統(tǒng)限流控制 |
| 400 | Unknown.ResourceOwnerId | The resource does not belong to the current user. | 資源不屬于當(dāng)前用戶 |
| 400 | MobileNumberIllegal | Wrong format of phone number | 手機(jī)號碼格式錯誤 |
| 400 | MobileNumberTypeNotMatch | Phone number and encryption type do not match | - |
| 400 | InputParamIllegal | Wrong format of input parameter | 參數(shù)格式錯誤 |
| 400 | AuthCodeIllegal | Illegal authCode. | 鑒權(quán)時使用的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. | 該標(biāo)簽申請單不存在，請重新更換授權(quán)碼 |
| 400 | AuthCodeNotExist | The authorization code is being applied and cannot be used. | 授權(quán)碼申請中，暫不可使用 |
| 400 | AuthCodeNotExist | The authorization code does not exist. | 授權(quán)碼不存在 |
| 400 | AuthCodeNotExist | The authorization code application failed and cannot be used. | 授權(quán)碼申請失敗，不可使用 |
| 400 | MobileNumberTypeIllegal | Invalid number type. | 號碼類型錯誤 |
| 400 | MobileNumberTypeIllegal | 號碼類型錯誤 | 號碼類型錯誤 |
| 400 | TagNotExist | The label does not exist. | 標(biāo)簽不存在 |
| 400 | InvalidParameter | Invalid parameter. | 無效參數(shù) |
| 500 | Unknown | Unknown error | 未知異常 |
| 500 | SystemError | System error | 系統(tǒng)異常 |
| 500 | RequestSupplierError | Request supplier error. | 請求第三方服務(wù)異常。 |
| 500 | RequestTimeout | Request supplier timed out. | 請求供應(yīng)商超時 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-04-02 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-09-12 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-09-11 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-05-17 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-04-28 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-04-18 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2022-09-22 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2022-09-21 | 新增 OpenAPI | 查看變更詳情 |