tencent cloud

Cloud Infinite

DokumentasiCloud InfiniteAPI DocumentationMedia ProcessingStream While ConvertingRetrieve Download Permission for Playback List

Retrieve Download Permission for Playback List

PDF
Mode fokus
Ukuran font
Terakhir diperbarui: 2025-09-09 10:15:10

Feature Overview

The GetPlayList API is used to obtain download authorization for private M3U8 ts resources.

Authorization Guide

When used with a sub-account, the ci:GetPlayList permission must be granted. For details, please refer to Cloud Infinite.

Service Activation

Using this feature requires enabling Cloud Infinite in advance and binding a bucket. For details, see Bind Bucket.
Using this feature requires enabling Media Processing Service in advance via console or API. For details, see Enable Media Processing Service.

Use Limits

When using this API, please first confirm the relevant restrictions. For details, see Specifications and Limits.
You need to enable allowlist to access this feature. Please Contact Us to enable it.

Fee Description

This API is a paid service. The incurred fees will be collected by Cloud Infinite. For detailed billing information, see Media Processing Fees.

Request

Request Sample

GET /<ObjectKey>?ci-process=getplaylist&expires= HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Note:
Authorization: Auth String. For details, see Request Signature documentation.
ObjectKey is a bucket object.

Request Parameters

Parameter Name
Description
Type
Required
ci-process
Operation type, fixed as getplaylist
String
No
expires
Relative validity period of the download credential for the private TS resource URL, in seconds, range [3600, 43200]
Int
Yes

Request Header

This API only uses common request headers. For details, see Common Request Headers documentation.

Request Body

This API has no request body.

Response

Response Header

This API only returns common response headers. For details, see Common Response Headers documentation.

Response Body

The response body contains m3u8 content, where the TS files are downloadable URLs.

Error Codes

This request returns common error responses and error codes. For more information, see Error Codes.

Practical Example

Request

GET /for-test.m3u8?ci-process=getplaylist&expires=3600 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=**********************************-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=**********************************
Content-Length: 0

Response

HTTP/1.1 200 OK
Content-Type: application/x-mpegURL
Content-Length: 266005
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-ci
x-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZm****

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:5
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5,
test-00000.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=0&playlist=
#EXTINF:5,
test-00001.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=1&playlist=
#EXTINF:5,
test-00002.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=2&playlist=
#EXTINF:5,
test-00003.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=3&playlist=
#EXTINF:5,
test-00004.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=4&playlist=
#EXT-X-ENDLIST


Topik sebelumnya: Generating a Playback ListTopik selanjutnya: Submitting Tasks

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan