驗證手機號是否為運營商二次放號的號碼,支持在一次請求中快速檢驗號碼是否為二次放號。
接口說明
- 請確保在使用本接口前,您已充分了解號碼百科產品定價。
- 當返回結果中:Code="OK" 且 VerifyResult != 0 時計費,其他情況不計費。
- 使用本接口前,請登錄號碼百科控制臺,在標簽廣場頁面,找到對應的標簽,單擊申請開通,填寫申請資料,審批通過后即可使用。
QPS 限制
本接口的單用戶 QPS 限制為 100 次/秒。超過限制,API 調用會被限流,這可能會影響您的業務,請合理調用。
授權信息
默認僅限阿里云賬號使用本接口,RAM 用戶只有在被授予了相關 API 操作權限后方可使用。具體請參見為 RAM 用戶授權。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
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 |
返回參數
狀態碼原因及解決方案
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 | AuthCodeNotExist | The authorization code is being applied and cannot be used. | 授權碼申請中,暫不可使用 |
400 | AuthCodeNotExist | The authorization code does not exist. | 授權碼不存在 |
400 | AuthCodeNotExist | The authorization code application failed and cannot be used. | 授權碼申請失敗,不可使用 |
400 | MobileNumberTypeIllegal | Invalid number type. | 號碼類型錯誤 |
400 | MobileNumberTypeIllegal | 號碼類型錯誤 | 號碼類型錯誤 |
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. | 請求供應商超時 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-04-02 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-09-12 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-09-11 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-05-17 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-04-28 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-04-18 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2022-09-22 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2022-09-21 | 新增 OpenAPI | 查看變更詳情 |