История запросов Public API

Что такое история запросов

История запросов Public API — это детальный журнал обработанных HTTP-запросов, выполненных через токены вашей организации. В историю попадают успешные ответы и обычные ошибки Public API, например 400/403/404/500. Запросы, отклонённые из-за исчерпанного месячного лимита Public API, не попадают в историю; в этом случае в разделе истории показывается отдельное предупреждение.

Какие данные показываются:

• Метод — HTTP-метод запроса (GET, POST и др.).
• Эндпоинт — полный путь, по которому был сделан запрос.
• Использованный токен — название API-токена, через который выполнялся запрос.
• Статус ответа — HTTP-код, который вернул сервер.
• Timestamp — точная дата и время запроса.

Где находится: Откройте Настройки организации > вкладка API > подвкладка История.

Кто имеет доступ: Просмотр истории запросов доступен Владельцу, Администратору и Редактору организации.

Фильтры и навигация

Для удобного анализа активности предусмотрены гибкие инструменты фильтрации и навигации:

Фильтр по токену:

• В верхней части страницы находится выпадающий список со всеми активными (и отозванными) токенами организации.
• Выберите конкретный токен, чтобы увидеть запросы, выполненные только через него.
• Это удобно для аудита конкретной интеграции или поиска источника подозрительной активности.

Пагинация:

• Навигация по страницам осуществляется кнопками Вперёд и Назад.
• Каждая страница содержит фиксированное количество записей для оптимальной производительности.

Как читать записи:

Каждая строка в истории показывает:

• HTTP-метод (GET выделяется одним цветом, POST — другим).
• Путь эндпоинта.
• Название токена.
• Код ответа (2xx — успех, отображается зелёным).
• Время запроса в локальном часовом поясе.

Хранение и ограничения

При работе с историей запросов учитывайте следующие особенности:

Срок хранения: Данные хранятся 30 дней. Запросы старше этого срока автоматически удаляются.

Асинхронная запись: Информация о запросах пишется асинхронно, поэтому свежие запросы могут появляться в истории с небольшой задержкой.

Ошибочные запросы: Обычные ошибки Public API (4xx, 5xx) отображаются в этой ленте вместе со статусом ответа. Не записываются только запросы, отклонённые из-за исчерпанного месячного лимита организации (api_request_limit_exceeded). Для диагностики ошибок используйте раздел Ошибки и коды.

Связанные разделы

• Public API — полная документация по работе с API.
• Лимиты и тарифы — информация о месячных лимитах запросов.
• Ошибки и коды — диагностика и решение ошибок API.
• Журнал аудита — отслеживание действий участников в интерфейсе.
• Безопасность и данные — рекомендации по защите токенов и данных.