查詢混流轉推事件訂閱記錄。
介面說明
本介面用於查詢混流轉推事件訂閱記錄,查詢範圍為近 7 天的資料。
QPS 限制
本介面的單使用者 QPS 限制為 100 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理呼叫。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
live:ListRtcMPUEventSubRecord |
list |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| AppId |
string |
是 |
訂閱的應用程式 ID。透過存取 影片直播>直播+>即時音影片>應用程式管理 可以查看擁有的應用程式 ID。 說明
|
yourAppId |
| SubId |
string |
否 |
訂閱的回呼 ID。 |
yourSubId |
| StartTime |
string |
是 |
查詢記錄的開始時間。 格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間),不得早於目前時間 7 天前。 |
1970-01-01T00:00:00Z |
| EndTime |
string |
是 |
查詢記錄的結束時間。 格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間),不得晚於目前時間。 |
1970-01-01T00:00:00Z |
| PageSize |
integer |
是 |
單頁顯示記錄的數量,取值範圍:1~100。 |
10 |
| PageNo |
integer |
是 |
頁碼。 |
20 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
******3B-0E1A-586A-AC29-742247****** |
| Count |
integer |
當前頁返回的回呼記錄總數。 |
1 |
| HasMore |
boolean |
是否有下一頁。 |
false |
| Logs |
array<object> |
回呼記錄。 |
|
|
object |
回呼記錄。 |
||
| AppId |
string |
訂閱的應用程式 ID。 |
yourAppId |
| SubId |
string |
事件回呼 ID。 |
Sub-******9799B2C4500****** |
| MsgId |
string |
回呼記錄 ID。 |
42bba8b5-********-9b501dd6cb6e |
| 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 |
回呼呼叫時間。 格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間) |
1970-01-01T00:00:00Z |
| Cost |
integer |
回呼時長,單位:毫秒。 |
22 |
| CallbackUrl |
string |
回呼地址。 |
http://testcallback***.com/callback |
| HTTPCode |
string |
錯誤碼,200 為回呼成功。 |
200 |
樣本
正常返回樣本
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"
}
]
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidParam | %s. | 參數校驗失敗。 |
| 400 | InvalidAppId | %s, please check and try again later. | AppId無效,請檢查後重試。 |
| 400 | MissingParam | %s, please check and try again later. | 參數缺失,請檢查後重試。 |
| 500 | InternalError | InternalError | |
| 403 | OperationDenied | Your account has not enabled the Live service | |
| 403 | Forbidden | %s, please check and try again later. | 無權限,請檢查後重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。