获取视频解密密钥

最近更新时间:2019-07-08 16:38:44

接口名称

DescribeDrmDataKey

功能说明

  • 获取云点播视频加密的数据密钥。数据密钥(Data Key,简称 DK)是由 KMS 系统生成的,用于对称加解密。
  • 视频加密使用云点播内置 KMS 服务来管理密钥时,本接口才能获取到视频加密的数据密钥。
  • 输入参数为加密的数据密钥(Encrypted Data Key,简称 EDK)。ProcessFile 接口带上加密参数时,事件通知消息会带上加密的 EDK 数据。
  • 获取到的数据密钥为 Base64 编码字符串。
  • 用户在视频加密任务处理成功后,调用本接口获取视频加密的数据密钥,并且需要自己保存数据密钥。当播放器播放加密视频时,会向用户的 Web 服务器发起获取数据密钥的请求,服务器需要将 Base64 编码格式的数据密钥转换为16字节二进制数据返回给播放器。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
edkList.n String 加密后的数据密钥列表,最大支持10个。
COMMON_PARAMS - 请参见 公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=DescribeDrmDataKey&edkList.0=CiCdpfV8oMGHlWuACHIGUxJ/mdjZnBWEsovP6k78xvj2qRCO08TAChiaoOvUBCokNTQ3N2MwYWQtMmVlYy00ZmNhLWE5OGQtNmNiNjc5MTVmODdh&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功;其他值:失败。
message String 错误信息。
data Ojbect 包含密钥列表的数据。
data.keyList Array 密钥列表,包含加密的数据密钥,字段信息请参见 keyList(密钥列表)

keyList(密钥列表)

参数名称 类型 说明
edk String 加密后的数据密钥。
dk String 数据密钥。返回的数据密钥 DK 为 Base64 编码字符串。

错误码说明

错误码 含义说明
4000 - 7000 请参见 公共错误码
1000 无效参数。
1001 用户信息错误。
10009 获取数据密钥错误,可能是输入的 EDK 错误。

应答示例

{
    "code": 0,
    "message": "",
    "data": {
        "keyList": [
            {
                "edk": "CiCdpfV8oMGHlWuACHIGUxJ/mdjZnBWEsovP6k78xvj2qRCO08TAChiaoOvUBCokNTQ3N2MwYWQtMmVlYy00ZmNhLWE5OGQtNmNiNjc5MTVmODdh",
                "dk": "i6zM/pnmIERJE3vAt0UnGg=="
            }
        ]
    }
}