# 获取应用使用趋势
查询应用在指定时间段内企业员工的使用趋势信息。warning
此接口目前仅支持小程序的使用情况查询，不支持网页应用和机器人应用的使用情况查询;仅支持查询自建应用，不支持查询商店应用

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/application/v1/app_usage_trend
HTTP Method | POST
频控说明 | 10次/分钟
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 获取员工使用应用概览数据

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体
|参数|类型|必须|说明|
|--|-----|--|----|
|app_id|string|是|目标应用的 ID，支持自建应用|
|ability|string|是|应用能力，mp：小程序|
|time_start|int|是|起始时间戳（秒），时间跨度最长支持180天|
|time_end|int|是|截止时间戳（秒），时间跨度最长支持180天|
|time_interval|int|是|步长（秒），最小步长为60秒，需满足(${time_end} - ${time_start}) / ${time_interval} <= 2*24*60|
|filters|list|否|过滤条件|
|&emsp;∟key|string|是|过滤字段，支持`department_id`|
|&emsp;∟op|string|是|过滤操作，支持`in`、`=`|
|&emsp;∟value|string|是|过滤字段值，多个使用英文逗号分隔|
<br>
### 请求体示例
```
{
        "app_id": "cli_xxx",
        "ability": "mp", 
        "time_start": 1598889600,
        "time_end": 1598975999, 
        "time_interval": 43200,
        "filters": [{ 
                "key": "department_id",
                "op": "in",
                "value": "od-xxxxx,od-yyyyy" 
        }]
}
```
## 响应
### 响应体
|参数|类型|说明|
|--|--|--|
|code|int|返回码，非0表示失败|
|msg|string|返回码的描述|
|data|-|返回的业务信息，仅code = 0时有效|
|&emsp;∟item|-|返回项|
|&emsp;&emsp;∟od-xxxxx|-|过滤字段值|
|&emsp;&emsp;&emsp;∟trends|list|趋势数据|
|&emsp;&emsp;&emsp;&emsp;∟timestamp|int|时间戳|
|&emsp;&emsp;&emsp;&emsp;∟pv|int|应用使用pv|
|&emsp;&emsp;&emsp;&emsp;∟uv|int|应用使用uv|
### 响应示例
```
{
        "code": 0,
        "msg": "success",
        "data": {
                "item": {
                        "od-xxxxx": {
                                "trends": [{
                                                "timestamp": 1598889600,
                                                "pv": 3,
                                                "uv": 3
                                        },
                                        {
                                                "timestamp": 1598932800,
                                                "pv": 7,
                                                "uv": 2
                                        }
                                ]
                        },
                        "od-yyyyy": {
                                "trends": [{
                                                "timestamp": 1598889600,
                                                "pv": 2,
                                                "uv": 1
                                        },
                                        {
                                                "timestamp": 1598932800,
                                                "pv": 18,
                                                "uv": 11
                                        }
                                ]
                        }
                }
        }
}
```