设备的使用情况统计接口

功能说明

具体包含设备的录制和直播时长,以及呼叫统计数据

默认接口请求频率限制：20次/秒。

实现方法

REST URL

POST https://sdk.xylink.com/api/rest/edu/external/statistics/device/usage/v1?enterpriseId=分配的企业id

请求参数说明

参数	参数类型	参数位置	必须	默认值	说明
departmentIds	List<Long>	Body	否	无	部门id集合(不超过10,否则报错)
areaType	Integer	Body	否	无	区域码(1-省，2-市，3-县)
areaCode	Long	Body	否	无	行政区域码
deviceId	String	Body	否	无	指定设备号时查询对应设备数据

示例代码

请求消息体示例（Json）

{
   "departmentIds":[12345, 12398], //强制规定数量不超过10个
   "deviceId":"123456"
}

或者

{
  "areaType":1/2/3,
  "areaCode":123,
  "deviceId":"123456"
}

补充说明: 部门、区域码必须二选一条件查询数据,部门优先级更高

示例代码

返回结果示例：备注:时长单位都统一默认为毫秒

成功时返回结果数据，失败时返回小鱼RESTAPI错误码

{
  "areaCode": 0, //区域码
  "areaName":"区域名称" //区域码对应的名称
  "recordDuration":0, //录制时长
  "liveDuration": 0, //直播时长
  "meetingDuration": 0, //会议时/呼叫的总时长
  "childs": [
    {
      "areaCode": 0,
      "areaName":""
      "recordDuration": 0,
      "liveDuration": 0,
      "meetingDuration": 0
    }
  ]
}

返回参数说明

参数名称	说明
areaCode	区域码
areaName	区域名称
recordDuration	录制时长
liveDuration	直播时长
meetingDuration	会议时/呼叫的总时长

2022-10-12 14:37:46

导出PDF文档