通過編程的方式在業務系統中集成短信服務的能力,使系統能夠根據業務的實際需要自動化發送短信,簡化運營、管理成本。本文為您介紹短信服務開放的OpenAPI及支持的集成方式。
OpenAPI介紹
想了解OpenAPI的完整調用鏈路流程及涉及到的身份、授權、憑證等信息,請參見什么是OpenAPI。
在線調試
短信服務提供短信發送、記錄查詢等多種OpenAPI,滿足您在業務系統中集成的需求。在調用前,您需要了解短信服務提供的版本、接入點說明、集成方式等信息。
版本說明
阿里云OpenAPI通過版本號管控各時期云產品大版本的API列表,例如短信服務目前支持2017-05-25
版本的API列表,2017-05-25
代表的是API版本號而非時間概念,所展示的都是最新的API公開數據,并非自2017-05-25
之后就未更新。
API 版本號 | 說明 |
推薦使用 |
服務接入點說明
服務接入點是訪問阿里云服務的入口點,即請求接口服務的網絡域名。根據相關資源所在地域,選擇對應的服務接入點地址,以獲得最低延遲。
可使用全局接入點域名dysmsapi.aliyuncs.com
。
更多信息,請參見服務接入點。
支持的調用身份
您阿里云賬號登錄OpenAPI網站后,OpenAPI默認使用您的阿里云賬號進行在線OpenAPI調試。阿里云賬號擁有所有API的訪問權限,風險很高。強烈建議您創建并使用RAM用戶進行API訪問或日常運維,請根據業務的實際情況按需分配權限后進行接口調用。RAM用戶需具備操作權限,詳情請參見使用RAM進行訪問控制。
用戶身份 | 支持情況 |
支持 | |
RAM用戶(推薦) | 支持 |
RAM角色(推薦) | 支持 |
更多信息
集成方式
SDK是最易于集成,且支持度最好的OpenAPI調用方式,推薦您選擇使用SDK。
集成方式 | 說明 |
阿里云SDK(推薦) | |
自定義封裝API調用(不推薦) | 原生HTTP調用需要您自己實現簽名算法,并構建自定義請求,發起HTTP調用。簽名機制及更多詳細信息,請參見V3版本請求體&簽名機制。 |
注意事項
如果調用短信服務API后返回錯誤,您需要根據返回的錯誤碼提示檢查傳入的請求參數及其取值是否正確。更多信息,請參見API錯誤碼。
您也可以記錄下調用返回的RequestID或SDK報錯信息,通過阿里云OpenAPI診斷平臺進行自助診斷。