調(diào)用DescribeUsageOsSdkVersionDistributionStatData獲取用量統(tǒng)計中各操作系統(tǒng)及SDK版本的分布數(shù)據(jù)。

使用說明

本接口用于獲取用量統(tǒng)計中各操作系統(tǒng)及SDK版本的分布數(shù)據(jù)。使用該接口時，限制如下：

  • 支持查詢最近365天（不包含查詢當天）任意范圍的數(shù)據(jù)。
  • 如果查詢范圍小于24小時，則按小時統(tǒng)計查詢的數(shù)據(jù)；如果查詢范圍大于或等于24小時，則按天統(tǒng)計查詢的數(shù)據(jù)。

QPS限制

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

調(diào)試

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

請求頭

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

請求語法

POST /api/usage/describeUsageOsSdkVersionDistributionStatData HTTP/1.1

請求參數(shù)

名稱 類型 位置 是否必選 示例值 描述
StartDate Long Query 是 1615824000

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

查詢的結(jié)束時間，使用UNIX時間戳表示，單位：秒。
AppId String Query 是 0rbd****

App ID，可通過控制臺創(chuàng)建和查詢。

返回數(shù)據(jù)

名稱 類型 示例值 描述
UsageOsSdkVersionStatList Array of UsageOsSdkVersionStatData

用量統(tǒng)計中操作系統(tǒng)及SDK版本的數(shù)據(jù)列表。
Name String 2.1.2104

SDK版本名稱。
Os String macOS

操作系統(tǒng)，例如iOS、Android等。
AudioCallDuration Long 0

音頻通話時長，單位：分鐘。
VideoCallDuration Long 1720

視頻通話時長，單位：分鐘。
TotalCallDuration Long 1720

總通話時長，單位：分鐘。
CallDurationRatio String 0.0768

通話時長占比，用四位小數(shù)表示，例如1.0000表示通話時長占比為100%。
RequestId String 579EA10B-8B89-449E-88E0-D362C76EAC62

請求ID。

示例

請求示例

POST /api/usage/describeUsageOsSdkVersionDistributionStatData?StartDate=1615824000&EndDate=1615910399&AppId=0rbd**** HTTP/1.1
Host: vdc.cn-shenzhen.aliyuncs.com 
Date: GMT Date

正常返回示例

XML格式 

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

<DescribeUsageOsSdkVersionDistributionStatDataResponse>
    <code>200</code>
    <data>
        <RequestId>579EA10B-8B89-449E-88E0-D362C76EAC62</RequestId>
        <UsageOsSdkVersionStatList>
            <AudioCallDuration>0</AudioCallDuration>
            <TotalCallDuration>1720</TotalCallDuration>
            <CallDurationRatio>0.0768</CallDurationRatio>
            <VideoCallDuration>1720</VideoCallDuration>
            <Os>macOS</Os>
            <Name>2.1.2104</Name>
        </UsageOsSdkVersionStatList>
        <UsageOsSdkVersionStatList>
            <AudioCallDuration>0</AudioCallDuration>
            <TotalCallDuration>1490</TotalCallDuration>
            <CallDurationRatio>0.0665</CallDurationRatio>
            <VideoCallDuration>1490</VideoCallDuration>
            <Os>macOS</Os>
            <Name>1.19.2</Name>
        </UsageOsSdkVersionStatList>
    </data>
    <httpStatusCode>200</httpStatusCode>
    <requestId>579EA10B-8B89-449E-88E0-D362C76EAC62</requestId>
    <successResponse>true</successResponse>
</DescribeUsageOsSdkVersionDistributionStatDataResponse>

JSON格式 

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

{
  "code" : "200",
  "data" : {
    "RequestId" : "579EA10B-8B89-449E-88E0-D362C76EAC62",
    "UsageOsSdkVersionStatList" : [ {
      "AudioCallDuration" : 0,
      "TotalCallDuration" : 1720,
      "CallDurationRatio" : "0.0768",
      "VideoCallDuration" : 1720,
      "Os" : "macOS",
      "Name" : "2.1.2104"
    }, {
      "AudioCallDuration" : 0,
      "TotalCallDuration" : 1490,
      "CallDurationRatio" : "0.0665",
      "VideoCallDuration" : 1490,
      "Os" : "macOS",
      "Name" : "1.19.2"
    } ]
  },
  "httpStatusCode" : "200",
  "requestId" : "579EA10B-8B89-449E-88E0-D362C76EAC62",
  "successResponse" : true
}