查詢手機用戶在運營商側的在網時長。
接口說明
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| AuthCode | string | 是 | 授權碼。 說明
在號碼百科控制臺我的申請頁面，獲取授權 ID 即授權碼。
| QASDW@#** |
| InputNumber | string | 是 | 待查詢的號碼。
注意 加密字符串中字母不區分大小寫。 | 1390000**** |
| Mask | string | 是 | 號碼的加密方式。取值：
| NORMAL |
| Carrier | string | 否 | 對外運營商。取值：
注意 非必填項，阿里云會根據號碼歸屬的運營商類型做自動判斷，該字段的取值對查詢結果無任何影響。 | UNICOM |
返回參數
狀態碼原因及解決方案
| HttpCode | 狀態碼 | 原因 | 解決方案 |
|---|---|---|---|
| 200 | OK：成功。 | 請求參數符合要求。 | 表示接口調用成功。 |
| 200 | PortabilityNumberNotSupported：不支持的號碼查詢。 | 有少部分攜號轉網號碼會返回此錯誤碼。 | 建議更換其他號碼查詢。攜號轉網的號碼在原運營商側已銷戶，新運營商側認為攜入的時間為開戶時間，因此攜號轉網的號碼無法準確的查詢到該號碼的真實情況。 |
異常原因及解決方案
| HttpCode | 狀態碼 | 原因 | 解決方案 |
|---|---|---|---|
| 400 | AuthCodeNotExist：授權碼不存在。 | 授權碼不存在。 | 請先在號碼分析服務申請您所需的標簽，申請成功并獲得授權碼后，再發起 DescribePhoneNumberOnlineTime 接口調用。 |
| 400 | CarrierIllegal：運營商類型非法。 | 運營商類型非法。 | 請您填入正確的運營商類型，對于加密的號碼，該字段必填且必須為大寫字符。 |
| 400 | MobileNumberIllegal：請求參數的手機號格式有誤。 | 手機號格式填寫有誤。 | 若手機號未加密，填入 11 位正確的數字號碼即可；若手機號經 MD5 加密處理，該字段為 32 位加密字符串；若手機號經 SHA256 加密處理，該字段為 64 位加密字符串。 |
| 400 | MobileNumberTypeNotMatch：手機號格式與加密類型不匹配。 | 填入的手機號與加密類型不匹配。 | 請您填入正確手機號格式和號碼加密類型。 |
| 400 | MobileNumberTypeIllegal：加密方式類型錯誤。 | 不支持的加密方式或加密類型不規范。 | 加密方式僅支持 NORMAL、MD5、SHA256 三種，且必須為大寫字符。 |
| 500 | Unknown：未知異常。 | 系統返回了未知異常。 | 請您嘗試重新調用接口，建議重試的次數不要超過 3 次。 |
| 500 | SystemError：網元系統異常。 | 系統錯誤。 | 請嘗試重新調用接口，建議重試次數不要超過 3 次。 |
示例
正常返回示例
JSON格式
{
"RequestId": "CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47",
"Code": "OK",
"Message": "OK",
"Data": {
"VerifyResult": "1",
"CarrierCode": "CMCC"
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 200 | PortabilityNumberNotSupported | Number portability is not supported | 不支持攜號轉網 |
| 400 | Insufficient.Balance | You have an insufficient balance. | 余額不足 |
| 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 | AuthCodeNotExist | Authorization code does not exist | - |
| 400 | CarrierIllegal | Illegal carrier type | 運營商類型非法 |
| 400 | MobileNumberIllegal | Wrong format of phone number | 手機號碼格式錯誤 |
| 400 | MobileNumberTypeNotMatch | Phone number and encryption type do not match | - |
| 400 | MobileNumberTypeIllegal | Invalid number type. | 號碼類型錯誤 |
| 400 | MobileNumberTypeIllegal | 號碼類型錯誤 | 號碼類型錯誤 |
| 400 | InvalidParameter | Invalid parameter. | 無效參數 |
| 400 | AuthCodeIllegal | Illegal authCode. | 鑒權時使用的authcode不可用于該接口 |
| 500 | SystemError | System error | 系統異常 |
| 500 | Unknown | Unknown error | 未知異常 |
| 500 | RequestTimeout | Request supplier timed out. | 請求供應商超時 |
| 500 | RequestSupplierError | Request supplier error. | 請求第三方服務異常。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-09-12 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-09-11 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-05-17 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2023-04-28 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |