使用OpenAPI調試號碼百科服務 - Cell Phone Number Service

通過編程的方式在業務系統中整合號碼百科服務的能力，做到根據業務的實際需要查詢號碼狀態，簡化營運、管理成本。本文介紹使用OpenAPI調試號碼百科的基本資料及注意事項。

OpenAPI介紹

為了能夠讓開發人員快速高效的學習和使用雲產品OpenAPI，阿里雲為使用者提供OpenAPI網站。它是一款集OpenAPI智能搜尋、文檔、線上調試、SDK擷取、CodeSample、調用出錯診斷、調用統計為一體的產品。您可以在OpenAPI門戶中調用阿里雲各雲產品開放的OpenAPI，查看OpenAPI請求和返回結果。此外，OpenAPI門戶會自動產生相應的SDK調用樣本，協助您快速使用阿里雲產品。更多資訊，請參見什麼是 OpenAPI。

版本說明

號碼百科服務提供碼狀態查詢，號碼移轉查詢，號碼歸屬地查詢和個人資訊核驗等多種OpenAPI，滿足您在業務系統中的整合需求。

說明

阿里雲OpenAPI通過版本號碼管控各時期雲產品大版本的API列表。

例如：號碼百科服務目前支援2023-01-01版本的API列表，2023-01-01代表的是API版本號碼而非時間概念，所展示的都是最新的API公開資料，並非自2023-01-01之後就未更新。

API 版本號碼	說明
2023-01-01	推薦使用

線上調試

號碼百科在OpenAPI門戶提供API調試等功能。在調用前，您需要瞭解號碼百科提供的版本、存取點、介面風格、調用方式等資訊。

調試入口

調試API入口為：https://api.alibabacloud.com/api/Dytnsapi/2023-01-01/

存取點說明

根據相關資源所在地區，選擇對應的服務存取點地址，以獲得最低延遲。

全域接入網域名稱dytnsapi.aliyuncs.com。更多資訊，請參見服務存取點。

支援的調用身份

您阿里雲帳號登入OpenAPI網站後，OpenAPI預設使用您的阿里雲帳號進行線上OpenAPI調試。

使用者身份	支援情況
阿里雲帳號	支援
RAM 使用者	不支援
RAM角色	不支援

整合方式

號碼百科服務提供SDK等多種整合方式，您可以根據業務的實際需要進行選擇。

阿里雲SDK

阿里雲為開發人員提供了多種程式設計語言（Java、C#、Go、Python、Node.js/TypeScript、PHP、C++等）的SDK。開發人員只需整合SDK，通過SDK暴露的方法直接調用OpenAPI。SDK統一封裝了簽名邏輯、逾時機制、重試機制，並根據文檔返回結構化Response對象，易於開發。更多關於阿里雲SDK的介紹，請參見阿里雲SDK。
號碼百科服務SDK支援的語言及依賴安裝方法請參見SDK參考。

阿里雲CLI

阿里雲命令列工具可以協助您在使用命令列終端時，通過aliyun命令與阿里雲服務進行互動，管理雲端服務資源。有關阿里雲CLI的更多詳細資料，請參見什麼是阿里雲CLI。
暫不支援使用阿里雲CLI調用號碼百科服務。

Resource Orchestration Service

Resource Orchestration Service服務ROS（Resource Orchestration Service）是阿里雲提供的一項簡化雲端運算資源管理的服務。開發人員和管理員可以編寫模板，在模板中定義所需的阿里雲資源（例如：ECS 執行個體、RDS 資料庫執行個體）、資源間的依賴關係等。ROS 的編排引擎將根據模板自動完成所有資源的建立和配置，實現自動化部署及營運。更多詳情，請參見什麼是Resource Orchestration Service服務。
暫不支援使用Resource Orchestration Service調用號碼百科服務。

自訂封裝API調用

如果以上方案均無法滿足您的業務需要，可自行封裝請求調用OpenAPI（不推薦），詳情請參見V3版本請求體&簽名機制。

注意事項

如果調用號碼百科API後返回錯誤，您需要根據返回的錯誤碼提示檢查傳入的請求參數及其取值是否正確。更多資訊，請參見錯誤碼中心。
您也可以記錄下調用返回的RequestID或SDK報錯資訊，通過阿里雲OpenAPI診斷平台進行自助診斷。