文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>对象存储>API 文档>数据处理接口>媒体处理>HLS 加密视频播放>查询 HLS 播放密钥

查询 HLS 播放密钥

最近更新时间：2025-08-11 17:23:13

我的收藏

本页目录：

功能描述

播放加密视频时，调用该接口 查询 HLS 播放密钥即 playKey，用于 生成签名token服务。

授权说明

通过子账号使用时，需要在 授权策略 的 action 中添加 ci:GetPlayKey 权限。数据万象支持的所有操作接口请参见 CI 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=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************
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>
中国站
目录