客戶端SDK

視頻點播提供播放器SDK、短視頻SDK、客戶端上傳SDK、美顏特效SDK等客戶端SDK，您可以根據業務需要選擇性集成相關功能。

例如：阿里云播放器SDK，結合視頻點播，支持多場景解決方案。易集成、全平臺兼容、高性能，并有全面的QoS/QoE數據服務，確保優質的觀看體驗。

客戶端SDK詳情請參見SDK簡介與下載。

OpenAPI

為了能夠讓開發者快速高效地學習和使用云產品OpenAPI，阿里云為用戶提供OpenAPI網站。它是一款集OpenAPI智能搜索、文檔、在線調試、SDK獲取、CodeSample、調用出錯診斷、調用統計為一體的產品。您可以在OpenAPI門戶中調用阿里云各云產品開放的OpenAPI，查看OpenAPI請求和返回結果。此外，OpenAPI門戶會自動生成相應的SDK調用示例，幫助您快速使用阿里云產品。更多信息，請參見什么是 OpenAPI。

OpenAPI版本說明

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

例如：視頻點播目前支持2017-03-21版本的API列表，2017-03-21代表的是API版本號而非時間概念，所展示API接口的是最新的API公開數據。

在線調試

視頻點播在OpenAPI門戶提供API調試等功能。在調用前，您需要了解視頻點播提供的版本、接入點說明、集成方式等信息。

調試入口

調試API入口為：https://next.api.aliyun.com/api/vod/2017-03-21/

接入點說明

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

視頻點播服務在多個地域均部署管控服務，可使用region化域名，格式為vod.{regionId}.aliyuncs.com。

如果想要獲得更快的響應速度，也可使用VPC域名，格式為vod-vpc.{regionId}.aliyuncs.com。

更多接入點信息請參見服務接入點。

支持的用戶身份

您阿里云賬號登錄OpenAPI網站后，OpenAPI默認使用您的阿里云賬號進行在線OpenAPI調試。阿里云賬號擁有所有API的訪問權限，風險很高。強烈建議您創建并使用RAM用戶進行API訪問或日常運維。請根據業務的實際情況按需分配權限后進行接口調用。RAM用戶需具備操作權限。具體操作，請參見使用RAM進行訪問控制。

OpenAPI集成方式

您可以通過以下方式調用視頻點播OpenAPI。阿里云SDK是最易于集成，且支持度最好的OpenAPI調用方式，推薦您選擇使用SDK。

阿里云SDK

視頻點播提供了多種主流語言的SDK，您可以基于阿里云SDK編寫代碼來調用視頻點播API，不用復雜編程即可實現視頻播放、視頻圖文水印、視頻剪輯、直播轉點播等功能，更多詳情請參見服務端SDK。

阿里云CLI

阿里云命令行工具可以幫助您在使用命令行終端時，使用aliyun命令與阿里云服務進行交互，管理云服務資源。有關阿里云CLI的更多詳細信息，請參見什么是阿里云CLI？。

Terraform

• Terraform 是一種開源工具，用于安全高效地預覽，配置和管理云基礎架構和資源。它與阿里云的資源編排服務的運行機制類似，通過將模板轉化為內部數據后完成 OpenAPI 調用。更多詳情，請參見什么是Terraform。

• 視頻點播支持Terraform編排和使用。支持部分普通資源和數據資源清單請參見視頻點播Terraform資源和數據源。

資源編排ROS

• 資源編排服務ROS（Resource Orchestration Service）是阿里云提供的一項簡化云計算資源管理的服務。開發者和管理員可以編寫模板，在模板中定義所需的阿里云資源（例如：ECS 實例、RDS 數據庫實例）、資源間的依賴關系等。ROS 的編排引擎將根據模板自動完成所有資源的創建和配置，實現自動化部署及運維。更多詳情，請參見什么是資源編排服務。

• 支持使用資源編排服務ROS調用視頻點播。編排的部分資源包括普通資源請參見VOD資源編排。

自定義封裝API調用

如果以上方案均無法滿足您的業務需要，可自行封裝請求調用OpenAPI（不推薦），原生HTTP調用需要您自己實現簽名算法，并構建自定義請求，發起HTTP調用。有關簽名機制的更多詳細信息，請參見V3版本請求體&簽名機制。

注意事項

• 如果調用視頻點播API后返回錯誤，您需要根據返回的錯誤碼提示檢查傳入的請求參數及其取值是否正確。更多信息，請參見公共錯誤碼。

• 您也可以記錄下調用返回的RequestID或SDK報錯信息，通過阿里云OpenAPI診斷平臺進行自助診斷。