Skip to main content

Формат ошибки

Ошибки возвращаются в формате OData v4 JSON:
  • code — машиночитаемый код: BadRequest, Unauthorized, Forbidden, NotFound, Conflict и т. д.
  • message — текст для человека, на русском. Ошибки разбора параметров запроса называют позицию символа (с 1).
  • details — у ошибок записи. Сообщения пользователю из бизнес-логики конфигурации (Сообщить, проверка заполнения) идут элементами с "code": "Message". target указывает на поле: Организация_Key, у строки табличной части — РасшифровкаПлатежа[0]/СуммаПлатежа, у строки набора движений — RecordSet[2]/Сумма.
Сырой текст исключения платформы или обработчика записи клиенту не отдаётся: в нём бывают тексты запросов и чужие данные. Вместо него приходит подробность "code": "Exception" с постоянным текстом, а сам текст исключения пишется в журнал регистрации (событие OData4.Запись). Настройка «Подробные ошибки записи клиенту» передаёт текст причины клиенту. Включайте её только на время отладки.

Коды ответов

Если ответ 500 пришёл не в формате OData ({"error": …}), а простым текстом платформы, это сбой платформы до кода расширения или после него. См. Известные ограничения.

Где искать подробности

  • Журнал запросов (вкладка «Журнал» формы настроек): статус, путь, субъект, длительность, текст ошибки (по флажку). См. Журнал и мониторинг.
  • Журнал регистрации 1С: события OData4.* с текстом исключения и стеком.