調用DescribeFaultDiagnosisUserList獲取異常診斷的用戶明細列表。

使用說明

本接口用于獲取異常診斷的用戶明細列表。使用該接口時，支持查詢最近48小時且查詢范圍不超過24小時的數據。

QPS限制

本接口的單用戶QPS限制為10次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見QPS限制。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求頭

該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數文檔。

請求語法

POST /api/diagnosis/describeFaultDiagnosisUserList HTTP/1.1

請求參數

名稱 類型 位置 是否必選 示例值 描述
AppId String Query 是 0rbd****

App ID，可通過控制臺創建和查詢。
StartTs Long Query 是 1615806196

查詢的開始時間，使用UNIX時間戳表示，單位：秒。
EndTs Long Query 是 1615892596

查詢的結束時間，使用UNIX時間戳表示，單位：秒。
ChannelId String Query 否 311

頻道ID。
UserId String Query 否 140c1f12****

用戶ID。
FaultTypes String Query 否 JOIN_SLOW,AUDIO_STUCK

過濾的異常類型，多個用英文逗號（,）分隔。取值：

  • JOIN_SLOW：進頻道慢。
  • AUDIO_STUCK：音頻卡頓。
  • VIDEO_STUCK：視頻卡頓。
  • VIDEO_VAGUE：視頻模糊。
  • HIGH_DELAY：通話延遲高。
  • FIRST_FRAME_SLOW：接收首屏慢。

關于異常類型詳情，請參見異常類型說明。

PageNo Integer Query 是 1

頁碼。
PageSize Integer Query 是 10

每頁數量。

返回數據

名稱 類型 示例值 描述
UserList Array of UserList

異常用戶的明細列表。
ChannelId String 311

頻道ID。
UserId String 140c1f12****

用戶ID。
CreatedTs Long 1620788012

第一次加入通話的時間，使用UNIX時間戳表示，單位：秒。
DestroyedTs Long 1620788861

最后一次離開通話的時間，使用UNIX時間戳表示，單位：秒。
ChannelCreatedTs Long 1620787721

創建通信的時間戳，使用UNIX時間戳表示，單位：秒。
FaultList Array of FaultData

異常列表。
FaultType String FIRST_FRAME_SLOW

異常類型。
PageNo Integer 1

頁碼。
PageSize Integer 10

每頁數量。
TotalCnt Integer 187

總數量。
RequestId String 99C8FAD2-F96B-4A24-B2E8-3EC9529BAD2C

請求ID。

示例

請求示例

POST /api/diagnosis/describeFaultDiagnosisUserList?AppId=0rbd****&StartTs=1615806196&EndTs=1615892596&ChannelId=311&UserId=140c1f12****&FaultTypes=JOIN_SLOW,AUDIO_STUCK&PageNo=1&PageSize=10 HTTP/1.1
Host: vdc.cn-shenzhen.aliyuncs.com 
Date: GMT Date

正常返回示例

XML格式 

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

<DescribeFaultDiagnosisUserListResponse>
    <code>200</code>
    <data>
        <RequestId>99C8FAD2-F96B-4A24-B2E8-3EC9529BAD2C</RequestId>
        <TotalCnt>187</TotalCnt>
        <PageSize>10</PageSize>
        <PageNo>1</PageNo>
        <UserList>
            <DestroyedTs>1620788861</DestroyedTs>
            <FaultList>
                <FaultType>FIRST_FRAME_SLOW</FaultType>
            </FaultList>
            <UserId>140c1f12****</UserId>
            <ChannelCreatedTs>1620787721</ChannelCreatedTs>
            <CreatedTs>1620788012</CreatedTs>
            <ChannelId>311</ChannelId>
        </UserList>
        <UserList>
            <DestroyedTs>1620787669</DestroyedTs>
            <FaultList>
                <FaultType>HIGH_DELAY</FaultType>
            </FaultList>
            <FaultList>
                <FaultType>VIDEO_STUCK</FaultType>
            </FaultList>
            <UserId>c31b3236****</UserId>
            <ChannelCreatedTs>1620786579</ChannelCreatedTs>
            <CreatedTs>1620786588</CreatedTs>
            <ChannelId>311</ChannelId>
        </UserList>
    </data>
    <httpStatusCode>200</httpStatusCode>
    <requestId>99C8FAD2-F96B-4A24-B2E8-3EC9529BAD2C</requestId>
    <successResponse>true</successResponse>
</DescribeFaultDiagnosisUserListResponse>

JSON格式 

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

{
  "code" : "200",
  "data" : {
    "RequestId" : "99C8FAD2-F96B-4A24-B2E8-3EC9529BAD2C",
    "TotalCnt" : 187,
    "PageSize" : 10,
    "PageNo" : 1,
    "UserList" : [ {
      "DestroyedTs" : 1620788861,
      "FaultList" : [ {
        "FaultType" : "FIRST_FRAME_SLOW"
      } ],
      "UserId" : "140c1f12****",
      "ChannelCreatedTs" : 1620787721,
      "CreatedTs" : 1620788012,
      "ChannelId" : "311"
    }, {
      "DestroyedTs" : 1620787669,
      "FaultList" : [ {
        "FaultType" : "HIGH_DELAY"
      }, {
        "FaultType" : "VIDEO_STUCK"
      } ],
      "UserId" : "c31b3236****",
      "ChannelCreatedTs" : 1620786579,
      "CreatedTs" : 1620786588,
      "ChannelId" : "311"
    } ]
  },
  "httpStatusCode" : "200",
  "requestId" : "99C8FAD2-F96B-4A24-B2E8-3EC9529BAD2C",
  "successResponse" : true
}