文档

查询混流转推事件订阅记录

调用ListRtcMPUEventSubRecord查询混流转推事件订阅记录。

使用说明

本接口用于查询混流转推事件订阅记录,查询范围为近7天的数据。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String ListRtcMPUEventSubRecord

系统规定参数。取值:ListRtcMPUEventSubRecord

AppId String yourAppId

订阅的应用ID。

说明 应用ID由大小写字母、数字、下划线、短划线(-)组成,最大64字符。
SubId String yourSubId

订阅的回调ID。

StartTime String 1970-01-01T00:00:00Z

查询记录的开始时间。

格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)

EndTime String 1970-01-01T00:00:00Z

查询记录的结束时间。

格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)

PageSize Integer 10

单页显示记录的数量,取值范围:1~100。

PageNo Integer 20

页码。

返回数据

名称

类型

示例值

描述

RequestId String ******3B-0E1A-586A-AC29-742247******

请求ID。

Count Long 1

当前页返回的回调记录总数。

HasMore Boolean false

是否有下一页。

Logs Array of SubInfo

回调记录。

AppId String yourAppId

订阅的应用ID。

SubId String Sub-******9799B2C4500******

事件回调ID。

MsgId String 42bba8b5-********-9b501dd6cb6e

回调记录ID。

Data String {\"EventType\":1,\"MsgId\":\"42bba8b5-94ab-468c-9dae-9b501dd6c***\",\"AppId\":\"rtcdev\",\"SubId\":\"Sub-9799B2C45009799B2C4***\",\"TaskId\":\"mpucallbacktest\",\"CallbackTs\":1712656430***,\"Payload\":{\"DstUrl\":\"rtmp://domain/app/stream?auth\",\"EventTs\":1712656430***,\"EventCode\":1,\"ErrorCode\":0,\"ErrorMessage\":\"\"}}

回调内容,详见创建混流转推事件回调

Time String 1970-01-01T00:00:00Z

回调调用时间。

格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)

Cost Long 22

回调时长,单位:毫秒。

CallbackUrl String http://testcallback***.com/callback

回调地址。

HTTPCode String 200

错误码,200为回调成功。

示例

请求示例

http(s)://[live.aliyuncs.com]/?Action=ListRtcMPUEventSubRecord
&AppId=yourAppId
&SubId=yourSubId
&StartTime=1970-01-01T00:00:00Z
&EndTime=1970-01-01T00:00:00Z
&PageSize=10
&PageNo=20
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListRtcMPUEventSubRecordResponse>
    <RequestId>******3B-0E1A-586A-AC29-742247******</RequestId>
    <Count>1</Count>
    <HasMore>false</HasMore>
    <Logs>
        <AppId>yourAppId</AppId>
        <SubId>Sub-******9799B2C4500******</SubId>
        <MsgId>42bba8b5-********-9b501dd6cb6e</MsgId>
        <Data>{\"EventType\":1,\"MsgId\":\"42bba8b5-94ab-468c-9dae-9b501dd6c***\",\"AppId\":\"rtcdev\",\"SubId\":\"Sub-9799B2C45009799B2C4***\",\"TaskId\":\"mpucallbacktest\",\"CallbackTs\":1712656430***,\"Payload\":{\"DstUrl\":\"rtmp://domain/app/stream?auth\",\"EventTs\":1712656430***,\"EventCode\":1,\"ErrorCode\":0,\"ErrorMessage\":\"\"}}</Data>
        <Time>1970-01-01T00:00:00Z</Time>
        <Cost>22</Cost>
        <CallbackUrl>http://testcallback***.com/callback</CallbackUrl>
        <HTTPCode>200</HTTPCode>
    </Logs>
</ListRtcMPUEventSubRecordResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "******3B-0E1A-586A-AC29-742247******",
  "Count" : 1,
  "HasMore" : false,
  "Logs" : [ {
    "AppId" : "yourAppId",
    "SubId" : "Sub-******9799B2C4500******",
    "MsgId" : "42bba8b5-********-9b501dd6cb6e",
    "Data" : "{\\\"EventType\\\":1,\\\"MsgId\\\":\\\"42bba8b5-94ab-468c-9dae-9b501dd6c***\\\",\\\"AppId\\\":\\\"rtcdev\\\",\\\"SubId\\\":\\\"Sub-9799B2C45009799B2C4***\\\",\\\"TaskId\\\":\\\"mpucallbacktest\\\",\\\"CallbackTs\\\":1712656430***,\\\"Payload\\\":{\\\"DstUrl\\\":\\\"rtmp://domain/app/stream?auth\\\",\\\"EventTs\\\":1712656430***,\\\"EventCode\\\":1,\\\"ErrorCode\\\":0,\\\"ErrorMessage\\\":\\\"\\\"}}",
    "Time" : "1970-01-01T00:00:00Z",
    "Cost" : 22,
    "CallbackUrl" : "http://testcallback***.com/callback",
    "HTTPCode" : "200"
  } ]
}

错误码

访问错误中心查看更多错误码。