Adds an episode list to a production studio for carousel playback.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes AddCasterEpisodeGroup

The operation that you want to perform. Set the value to AddCasterEpisodeGroup.

CallbackUrl String Yes http://sophon/aliyunlive:8000/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f****

The callback URL.

ClientToken String Yes 8751ad99-2ddb-4aac-ad44-84b21102****

The client token that is used to ensure the idempotence of the request.

You can use the client to generate a token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

DomainName String Yes sophab-test.aliyunlive.com

The main streaming domain.

RepeatNum Integer Yes 0

The number of times the episode list repeats after the first playback is complete. Valid values:

  • 0: indicates that the episode list is played only once.
  • -1: indicates that the episode list is played in loop mode.
SideOutputUrl String Yes http://side/aliyunlive:8000/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f****

The custom standby URL.

StartTime String Yes 2018-03-06T19:00:00Z

The time when the episode list starts to play. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

RegionId String No cn-shanghai

The ID of the region.

Item.N.ItemName String No Episode 1

The name of episode N.

Item.N.VodUrl String No http://sophon/aliyunlive:8000/caster/4a82a3d1b7f0462ea37348366201****.flv?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f****

The URL of the VOD file.

This parameter takes effect only when the video resource is a video file that is not from the media library.

The video file must be in the MP4, FLV, or TS format.

Response parameters

Parameter Type Example Description
ItemIds List [ "21926b36-7dd2-4fde-ae25-51b5bc8e****", "21926b36-7dd2-4fde-ae25-51b5bc98****" ]

The IDs of episodes in the list.

ProgramId String 16A96B9A-F203-4EC5-8E43-CB92E68X****

The ID of the episode list that was added.

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/? Action=AddCasterEpisodeGroup
&CallbackUrl=http://sophon/aliyunlive:8000/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f****
&ClientToken=8751ad99-2ddb-4aac-ad44-84b21102****
&DomainName=sophab-test.aliyunlive.com
&RepeatNum=3
&SideOutputUrl=http://side/aliyunlive:8000/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f****
&StartTime=2018-03-06T19:00:00Z
&<Common request parameters>

Sample success responses

XML format

<AddCasterEpisodeGroupResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
      <ProgramId>16A96B9A-F203-4EC5-8E43-CB92E68X****</ProgramId>
      <ItemIds>21926b36-7dd2-4fde-ae25-51b5bc8e****</ItemIds>
      <ItemIds>21926b36-7dd2-4fde-ae25-51b5bc98****</ItemIds>
</AddCasterEpisodeGroupResponse>

JSON format

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
    "ProgramId": "16A96B9A-F203-4EC5-8E43-CB92E68X****",
    "ItemIds": [
      "21926b36-7dd2-4fde-ae25-51b5bc8e****",
      "21926b36-7dd2-4fde-ae25-51b5bc98****"
    ]
}

Error codes

For a list of error codes, visit the API Error Center.