使用說明

本接口用于查詢單次通信詳情。例如：您可以查詢通訊狀態、用戶詳情等信息。

QPS限制

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

請求頭

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

請求語法

POST /api/call/describeCall HTTP/1.1

請求參數

返回數據

示例

請求示例

POST api/call/describeCall?AppId=pdtk****&ChannelId=1230&CreatedTs=1616564129&DestroyedTs=1616564304 HTTP/1.1 
Host: vdc.cn-shenzhen.aliyuncs.com 
Date: GMT Date

正常返回示例

XML格式

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

<DscribeCallResponse>
<requestId>EC4960AA-A407-4853-975E-D68F253E18FF</requestId>
<code>200</code>
<message/>
<action/>
<apiName/>
<extendedCode/>
<bizCode/>
<httpStatusCode>200</httpStatusCode>
<data>
    <RequestId>EC4960AA-A407-4853-975E-D68F253E18FF</RequestId>
    <CallInfo>
        <DestroyedTs>1616564304</DestroyedTs>
        <AppId>pdtkb2qy</AppId>
        <CallStatus>OUT</CallStatus>
        <Duration>175</Duration>
        <CreatedTs>1616564129</CreatedTs>
        <ChannelId>1230</ChannelId>
    </CallInfo>
    <UserDetailList>
        <Os>macOS</Os>
        <SdkVersion>2.0.0.210324.dev--release/rtcsdk_v2.0</SdkVersion>
        <Duration>175</Duration>
        <OnlineDuration>175</OnlineDuration>
        <DestroyedTs>1616564304</DestroyedTs>
        <CallExp>GOOD</CallExp>
        <UserId>29ebdab59ba891c3</UserId>
        <Network>WiFi</Network>
        <CreatedTs>1616564129</CreatedTs>
        <OnlinePeriods>
            <LeaveTs>1616564304</LeaveTs>
            <JoinTs>1616564129</JoinTs>
        </OnlinePeriods>
        <Location>浙江省-杭州市</Location>
        <DurMetricStatData/>
    </UserDetailList>
    <UserDetailList>
        <Os>Android</Os>
        <SdkVersion>2.1.2103191</SdkVersion>
        <Duration>112</Duration>
        <OnlineDuration>102</OnlineDuration>
        <DestroyedTs>1616564253</DestroyedTs>
        <CallExp>GOOD</CallExp>
        <UserId>c31b32364ce1</UserId>
        <Network>WiFi</Network>
        <CreatedTs>1616564141</CreatedTs>
        <OnlinePeriods>
            <LeaveTs>1616564207</LeaveTs>
            <JoinTs>1616564141</JoinTs>
        </OnlinePeriods>
        <OnlinePeriods>
            <LeaveTs>1616564253</LeaveTs>
            <JoinTs>1616564217</JoinTs>
        </OnlinePeriods>
        <Location>浙江省-杭州市</Location>
        <DurMetricStatData/>
    </UserDetailList>
</data>
<successResponse>true</successResponse>
</DscribeCallResponse>

JSON格式

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

{
  "requestId" : "EC4960AA-A407-4853-975E-D68F253E18FF",
  "code" : "200",
  "httpStatusCode" : "200",
  "data" : {
    "RequestId" : "EC4960AA-A407-4853-975E-D68F253E18FF",
    "CallInfo" : {
      "DestroyedTs" : 1616564304,
      "AppId" : "pdtkb2qy",
      "CallStatus" : "OUT",
      "Duration" : 175,
      "CreatedTs" : 1616564129,
      "ChannelId" : "1230"
    },
    "UserDetailList" : [ {
      "Os" : "macOS",
      "SdkVersion" : "2.0.0.210324.dev--release/rtcsdk_v2.0",
      "Duration" : 175,
      "Roles" : [ ],
      "OnlineDuration" : 175,
      "DestroyedTs" : 1616564304,
      "CallExp" : "GOOD",
      "UserId" : "29ebdab59ba891c3",
      "Network" : "WiFi",
      "CreatedTs" : 1616564129,
      "OnlinePeriods" : [ {
        "LeaveTs" : 1616564304,
        "JoinTs" : 1616564129
      } ],
      "Location" : "浙江省-杭州市",
      "DurMetricStatData" : { }
    }, {
      "Os" : "Android",
      "SdkVersion" : "2.1.2103191",
      "Duration" : 112,
      "Roles" : [ ],
      "OnlineDuration" : 102,
      "DestroyedTs" : 1616564253,
      "CallExp" : "GOOD",
      "UserId" : "c31b32364ce1",
      "Network" : "WiFi",
      "CreatedTs" : 1616564141,
      "OnlinePeriods" : [ {
        "LeaveTs" : 1616564207,
        "JoinTs" : 1616564141
      }, {
        "LeaveTs" : 1616564253,
        "JoinTs" : 1616564217
      } ],
      "Location" : "浙江省-杭州市",
      "DurMetricStatData" : { }
    } ]
  },
  "successResponse" : true
}