API и интеграции

Журнал API и webhook

Фильтры, request ID, маскированные адреса и понятная карта HTTP 400–5xx для самостоятельной диагностики.

Обновлено 22.08.2026
Время чтения 13 мин
Сложность Средний
Цель инструкции

Найти причину ошибки без передачи секретов поддержке.

Короткий маршрут

Что вы сделаете

Откройте нужный шаг сразу или идите по порядку. Проверка результата остаётся в самой инструкции.

  1. 01 Где смотреть
  2. 02 Карта статусов
  3. 03 Что отправить поддержке
  4. 04 Когда повторять

Результат: вы найдёте конкретную неуспешную операцию и соберёте безопасные данные для исправления.

Где смотреть

Откройте «Настройки → Интеграции → Журнал». Разделяйте REST-запросы и исходящие webhook: у них разные инициаторы и причины ошибок.

REST-журнал платформы с фильтрами и статусом ответа
Для REST сверяйте метод, путь, время, статус и request ID.
Журнал webhook платформы с маскированным URL
Для webhook дополнительно сверяйте событие, попытку и ответ внешней системы.

Карта статусов

Код Обычно означает Что сделать
400 Неверный запрос Сверить параметры
401 Нет или неверен секрет Проверить Bearer/подпись, не публикуя значение
403 Недостаточно прав Добавить только нужный scope
404 Путь или объект не найден Сверить ID и организацию
405 Неверный HTTP-метод Сверить GET/POST/PATCH
409 Конфликт состояния Перечитать объект
413 Слишком большое тело Уменьшить тело запроса или проверить лимит
415 Неверный Content-Type Отправить JSON
422 Ошибка полей Сверить схему OpenAPI
429 Лимит скорости Замедлить запросы
5xx Временная серверная ошибка Повторить с увеличивающейся паузой

Что отправить поддержке

  • UTC-время и часовой пояс;
  • тип операции и безопасный путь без query-секретов;
  • HTTP-статус;
  • X-Request-Id;
  • ожидаемый и фактический результат;
  • признак, повторяется ли ошибка на вымышленных тестовых данных.

Не отправляйте токен, secret, полный Bitrix/n8n webhook, персональные поля и полный дамп запроса.

Когда повторять

GET обычно можно повторить. POST повторяйте только с документированной идемпотентностью. Для webhook платформа сама повторяет только классы ошибок, закреплённые в публичном контракте.

Дальше: чек-лист безопасности интеграций.

Нужна помощь с запуском?

Если не хочется разбираться самостоятельно, мы можем помочь. Поможем настроить платформу под вашу задачу и быстрее запустить проект без лишних шагов.