User Guide
API (OId Version)
Calling Methods
Request Syntax
Common Parameters
Response
Data Structure
Authentication V3
Upload
Asset MGMT
Video Processing
Video Playback
Appendix
API (New)
Tool and SDK

Request Syntax

更新时间:2023-03-06 16:26:06

API域名

api.cloudv.haplat.net

协议

您可以通过 HTTP 或 HTTPS 发送请求。为确保您的请求安全,我们建议通过 HTTPS 发送请求。

请求方法

API 支持 POST 或 GET 请求。

  • 对于 POST 请求:支持“application/json”和“application/x-www-form-urlencoded”的内容类型。
  • 对于获取请求:仅支持“内容类型:应用程序/x-www-form-urlencoded”。

请求参数

每个请求都需要使用相应的接口,并携带公共请求参数,以及指定操作特有的请求参数。

对于 HTTP Headers,除了一些常用的 Headers 之外,还应该包括一些 Cloud VoD 定义的额外 Headers,例如 X-WS-AccessKey、X-WS-Timestamp、Authorization、content-Type 和 host。

以下是 Cloud VoD 定义的请求头:

请求头 描述
X-WS-AccessKey 您的访问密钥 ID。您可以在控制台的安全设置>访问控制>用户信息管理> AccessKey管理下查看。
X-WS-Timestamp 当前时间戳,单位秒。
Authorization HTTP 标准身份验证标头。有关详细信息,请访问身份验证 V3
content-Type 实际发送到服务器的数据类型。
host Cloud VoD API 域,固定在api.cloudv.haplat.net

例子

#标准http头
User-Agent: Mozilla/5.0 (Windows NT 5.1; rv:5.0) Gecko/20100101 Firefox/5.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: zh-cn,zh;q=0.5
Accept-Encoding: gzip, deflate
Accept-Charset: GB2312,utf-8;q=0.7,*;q=0.7
Connection: keep-alive
#公共参数:
Authorization: WS3-HMAC-SHA256 Credential=AKIDz8krbsJ5yKBZQpn74WFkmLPx3EXAMPLE, SignedHeaders=content-type;host, Signature=792dcb6d648a456a030c9c6683fa7bde2a31cb4c72cfeaa354da000adf7c288d
Content-Type: application/json; charset=utf-8
Host: api.cloudv.haplat.net
X-WS-AccessKey: AKIDz8krbsJ5yKBZQpn74WFkmLPx3EXAMPLE
X-WS-Timestamp: 1564645579

字符编码

所有请求和响应都应以 UTF-8 编码。

本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!