> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Получить статистику сообщений сервера

> Возвращает статистику сообщений только выбранного согласованного сервера.

Возвращает статистику сообщений только выбранного согласованного сервера. Требуется statistics:read. Поля stale и current\_partial показывают актуальность и полноту текущих данных источника.

## Доступ

`statistics:read`.

**Authorization** `string` *required*

Партнёрский Bearer-токен. Подробнее в разделе [«Авторизация»](https://docs.arzguard.com/cerberus-crm/authentication.md).

## Параметры

**server\_id** `union` *required*

Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.

## Успешный ответ

HTTP `200`. Запрос выполнен успешно.

**current\_partial** `boolean` *required*

Данные за текущий период ещё неполные.

**date** `string` *required*

Дата, к которой относятся данные.

**fetched\_at** `string` *required*

Дата и время получения данных источника.

Формат `date-time`.

**period** `string` *required*

Период статистики.

**previous\_date** `string` *required*

Дата предыдущего периода статистики.

**servers** `object[] | null` *required*

Согласованные серверы бота.

**Поля**

**delta** `integer | null` *required*

Изменение показателя относительно предыдущего периода.

**generated\_at** `string | null` *required*

Дата и время формирования данных источником.

Формат `date-time`.

**number** `integer` *required*

Номер сервера.

**previous\_generated\_at** `string | null` *required*

Время формирования предыдущих данных.

Формат `date-time`.

**previous\_status** `string` *required*

Состояние записи до изменения.

**previous\_total\_messages** `integer | null` *required*

Количество сообщений за предыдущий период.

**status** `string` *required*

Текущее состояние записи.

**total\_messages** `integer | null` *required*

Количество сообщений за период.

**stale** `boolean` *required*

Источник пометил данные как устаревшие.

**timezone** `string` *required*

Часовой пояс данных.

## Ошибки

| HTTP | Значение |
| - | - |
| `400` | Некорректные параметры запроса. |
| `401` | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
| `403` | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
| `404` | Запись не найдена или недоступна в данном контексте. |
| `409` | Конфликт состояния или ключа идемпотентности. Получите актуальную ревизию перед новым действием. |
| `413` | Размер тела запроса или загружаемого файла превышает допустимый предел. |
| `422` | Данные не прошли проверку формата или ограничений. Подробности находятся в поле errors. |
| `429` | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
| `500` | Внутренняя ошибка сервера. |
| `503` | Сервис временно недоступен. Повторите запрос позднее. |

См. [формат ошибок и правила повторов](https://docs.arzguard.com/cerberus-crm/requests-and-errors.md).

## Пример

В примере использованы условные идентификаторы.

```bash cURL theme={null}
curl --request GET \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  'https://test.crm.arzguard.com/api/partner/v1/servers/102/statistics'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "current_partial": false,
  "date": "example",
  "fetched_at": "2026-11-16T12:00:00+03:00",
  "period": "day",
  "previous_date": "example",
  "servers": [],
  "stale": false
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.