有奖:语音产品征文挑战赛等你来> HOT

功能描述

该接口用于获取 HLS 播放密钥。

授权说明

授权策略中 action 设置为 ci:GetPlayKey。查看所有 action

请求

请求示例

GET /playKey HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml

说明
Authorization: Auth String(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求的请求体为空。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<RequestId></RequestId>
<PlayKeyList>
<MasterPlayKey></MasterPlayKey>
<BackupPlayKey></BackupPlayKey>
</PlayKeyList>
</Response>
具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
Response
保存结果的容器
Container

Container 节点 Response 的内容
节点名称(关键字)
父节点
描述
类型
RequestId
Response
请求的唯一 ID
String
PlayKeyList
Response
保存播放密钥的容器
Container

Container 节点 PlayKeyList 的内容
节点名称(关键字)
父节点
描述
类型
MasterPlayKey
Response.PlayKeyList
主播放密钥
String
BackupPlayKey
Response.PlayKeyList
备播放密钥
String

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

实际案例

请求

GET /playKey HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host: test-1234567890.ci.ap-beijing.myqcloud.com
Content-Length: 0
Content-Type: application/xml


响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 100
Connection: keep-alive
Date: Thu, 14 Jul 2022 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
<RequestId>NjQ0NGNlNDZfMThhYTk0MGFfY*********</RequestId>
<PlayKeyList>
<MasterPlayKey>122fde9d792c4238be64925b3189e718</MasterPlayKey>
<BackupPlayKey>acd233e114a74394ac3e3eac0b86fe68</BackupPlayKey>
</PlayKeyList>
</Response>