调用DescribeCasterProgram查询导播台节目单。
使用说明
调用本接口查询导播台节目单,本接口目前支持的节点类型为视频源和组件。
QPS限制
本接口的单用户QPS限制为4次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeCasterProgram |
系统规定参数。取值:DescribeCasterProgram。 |
CasterId | String | 是 | LIVEPRODUCER_POST-cn-0pp1czt**** |
导播台ID。如果您通过CreateCaster接口创建导播台,请查看CreateCaster接口调用返回的参数CasterId值。 |
RegionId | String | 否 | cn-shanghai |
地域ID。 |
EpisodeId | String | 否 | 1872639A-F203-4EC5-8E43-CB92E68F**** |
节目ID。 |
EpisodeType | String | 否 | Resource |
节点类型。取值:
|
StartTime | String | 否 | 2016-06-29T09:00:00Z |
起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
EndTime | String | 否 | 2016-06-29T10:00:00Z |
结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
PageNum | Integer | 否 | 5 |
页码。 |
PageSize | Integer | 否 | 10 |
每页节目数量。 |
Status | Integer | 否 | 0 |
节目状态。 取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
CasterId | String | LIVEPRODUCER_POST-cn-0pp1czt**** |
导播台ID。 |
Episodes | Array of Episode |
节点列表。 |
|
Episode | |||
ComponentIds | List | ["1872639A-F203-4EC5-8E43-CB929282****" ] |
组件列表。 |
EndTime | String | 2016-06-29T10:02:00Z |
结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
EpisodeId | String | 1872639A-F203-4EC5-8E43-CB92E68F**** |
节目ID。 |
EpisodeName | String | program_name_1 |
节目名称。 |
EpisodeType | String | Resource |
节点类型。 取值:
|
ResourceId | String | 1872639A-F203-4EC5-8E43-CB92E837**** |
视频源ID。 |
StartTime | String | 2016-06-29T09:00:00Z |
起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Status | Integer | 0 |
节目状态。 |
SwitchType | String | TimeFirst |
切换策略。取值:
|
ProgramEffect | Integer | 1 |
启用标志。
|
ProgramName | String | programs_name |
节目单名称。 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
Total | Integer | 1 |
总记录数。 |
示例
请求示例
https://live.aliyuncs.com/?Action=DescribeCasterProgram
&CasterId=LIVEPRODUCER_POST-cn-0pp1czt****
&<公共请求参数>
正常返回示例
XML
格式
<DescribeCasterProgramResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
<ProgramId>1872639A-F203-4EC5-8E43-CB92E68F****</ProgramId>
<ProgramName>programs_name</ProgramName>
<ProgramEffect>1</ProgramEffect>
<Episodes>
<EpisodeId>1872639A-F203-4EC5-8E43-CB92E68F****</EpisodeId>
<EpisodeType>Resource</EpisodeType>
<EpisodeName>program_name_1</EpisodeName>
<ResourceId>1872639A-F203-4EC5-8E43-CB92E837****</ResourceId>
<ComponentIds>1872639A-F203-4EC5-8E43-CB929282****</ComponentIds>
<StartTime>2016-06-29T09:00:00Z</StartTime>
<EndTime>2016-06-29T10:02:00Z</EndTime>
<Duration>120</Duration>
<SwitchType>TimeFirst</SwitchType>
</Episodes>
<Episodes>
<EpisodeId>1872639A-F203-4EC5-8E43-CB92E687****</EpisodeId>
<EpisodeType>Component</EpisodeType>
<ComponentIds>1872639A-F203-4EC5-8E43-CB625364****</ComponentIds>
<StartTime>2016-06-29T19:02:00Z</StartTime>
<EndTime>2016-06-29T19:04:00Z</EndTime>
</Episodes>
</DescribeCasterProgramResponse>
JSON
格式
{
"DescribeCasterProgramResponse": {
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
"ProgramId": "1872639A-F203-4EC5-8E43-CB92E68F****",
"ProgramName": "programs_name",
"ProgramEffect": 1,
"Episodes": [
{
"EpisodeId": "1872639A-F203-4EC5-8E43-CB92E68F****",
"EpisodeType": "Resource",
"EpisodeName": "program_name_1",
"ResourceId": "1872639A-F203-4EC5-8E43-CB92E837****",
"ComponentIds": "1872639A-F203-4EC5-8E43-CB929282****",
"StartTime": "2016-06-29T09:00:00Z",
"EndTime": "2016-06-29T10:02:00Z",
"Duration": 120,
"SwitchType": "TimeFirst"
},
{
"EpisodeId": "1872639A-F203-4EC5-8E43-CB92E687****",
"EpisodeType": "Component",
"ComponentIds": "1872639A-F203-4EC5-8E43-CB625364****",
"StartTime": "2016-06-29T19:02:00Z",
"EndTime": "2016-06-29T19:04:00Z"
}
]
}
}
错误码
访问错误中心查看更多错误码。