Аналитика активности пространства
GET /v1/activity
GET /v1/activity
Нетарифицируемое чтение с правом usage:read. Фильтрует записанные тарифицируемые попытки по полуоткрытому интервалу UTC не длиннее 366 дней. Почасовые графики доступны до 31 дня. Итоги текущего и предыдущего интервалов одинаковой длительности, восемь лидирующих групп с остальными в Other и график с нулевыми пропусками используют одинаковые фильтры. Запрос ограничен пространством учётных данных. Имена участников доступны только сессиям кабинета. Неизвестное время ответа остаётся null. Расход включает текущие резервы без ошибок; чтение не меняет квоту или баланс пространства.
Доступ
Требуется bearer-авторизация. Описание операции задаёт дополнительные права, роли и ограничения для сессий кабинета. Сам по себе API-ключ их не предоставляет.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
from (query) | string | да | Начало интервала включительно: временная метка ISO в UTC. Длительность должна быть положительной и не превышать 366 дней. |
to (query) | string | да | Конец интервала не включается: временная метка ISO в UTC. Допускаются будущие календарные границы. |
granularity (query) | "day" ∣ "hour" | нет | Интервалы по UTC. Почасовые графики доступны для периода не длиннее 31 дня. |
group_by (query) | "tool" ∣ "key" ∣ "member" ∣ "connection" ∣ "channel" ∣ "environment" ∣ "status" | нет | |
tool (query) | string ∣ null | нет | |
key_id (query) | string ∣ null | нет | |
member_id (query) | string ∣ null | нет | |
connection_id (query) | string ∣ null | нет | |
channel (query) | "rest" ∣ "mcp" ∣ null | нет | |
environment (query) | "live" ∣ "test" ∣ null | нет | |
status (query) | "reserved" ∣ "success" ∣ "error" ∣ null | нет | |
q (query) | string ∣ null | нет | Поиск буквального фрагмента ID запроса или имени инструмента. |
Тело запроса
Тело запроса не требуется.
Ответы
| HTTP | Описание | Тип |
|---|---|---|
| 200 | Успешный ответ | application/json: ActivityReport |
| 401 | Требуется авторизация | application/problem+json: ProblemDetails |
| 403 | Доступ запрещён | application/problem+json: ProblemDetails |
| 404 | Не найдено | application/problem+json: ProblemDetails |
| 422 | Ошибка входных данных | application/problem+json: ProblemDetails |
| 503 | Сервис недоступен | application/problem+json: ProblemDetails |
Ответ: ActivityReport
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
from | string | да | |
to | string | да | |
granularity | "day" ∣ "hour" | да | |
group_by | "tool" ∣ "key" ∣ "member" ∣ "connection" ∣ "channel" ∣ "environment" ∣ "status" | да | |
totals | ActivityMetrics | да | |
previous | ActivityComparison | да | Непосредственно предшествующий интервал той же длительности с теми же фильтрами. |
groups | ActivityGroup[] | да | Восемь лидирующих групп по числу запросов, затем при необходимости группа остальных Other. |
buckets | ActivityBucket[] | да | Интервалы UTC с заполнением пропусков нулями и теми же идентификаторами, что в groups. |
truncated_groups | boolean | да |
Полная схема
{
"properties": {
"from": {
"type": "string",
"format": "date-time",
"title": "From"
},
"to": {
"type": "string",
"format": "date-time",
"title": "To"
},
"granularity": {
"type": "string",
"enum": [
"day",
"hour"
],
"title": "Granularity"
},
"group_by": {
"type": "string",
"enum": [
"tool",
"key",
"member",
"connection",
"channel",
"environment",
"status"
],
"title": "Group By"
},
"totals": {
"$ref": "#/components/schemas/ActivityMetrics"
},
"previous": {
"$ref": "#/components/schemas/ActivityComparison",
"description": "Immediately preceding equal-duration interval with the same filters."
},
"groups": {
"items": {
"$ref": "#/components/schemas/ActivityGroup"
},
"type": "array",
"title": "Groups",
"description": "Top eight groups by requests, followed by Other when needed."
},
"buckets": {
"items": {
"$ref": "#/components/schemas/ActivityBucket"
},
"type": "array",
"title": "Buckets",
"description": "Zero-filled UTC buckets with the same group identifiers as groups."
},
"truncated_groups": {
"type": "boolean",
"title": "Truncated Groups"
}
},
"type": "object",
"required": [
"from",
"to",
"granularity",
"group_by",
"totals",
"previous",
"groups",
"buckets",
"truncated_groups"
],
"title": "ActivityReport"
}Эта страница генерируется из OpenAPI. Примеры показывают схемы, а не вымышленные успешные ответы.