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 编码。

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