Интеграциисредний

HTTP-сервисы в 1С: принимаем JSON и не падаем

Шаблоны URL, методы, чтение тела запроса и коды ответов. Плюс разбор ошибок, из-за которых обмен с сайтом молча ломается.

6 ноября 202611 мин чтенияавтор: idkodr
Содержание
Каркас методаКоды ответов, которые должен знать сайтКодировка и пустое тело

Каркас метода

HTTP-сервис в 1С — это модуль с функциями вида ЗаказPOST, ЗаказGET. Платформа сама вызывает нужную функцию по методу запроса. Главное правило: всегда возвращай осмысленный код ответа, а не падай с исключением.

МодульHTTPСервиса.bsl
Функция ЗаказPOST(Запрос)    Ответ = Новый HTTPСервисОтвет(200);    Ответ.Заголовки.Вставить("Content-Type", "application/json; charset=utf-8");    Попытка        Тело = Запрос.ПолучитьТелоКакСтроку();        Чтение = Новый ЧтениеJSON;        Чтение.УстановитьСтроку(Тело);        Данные = ПрочитатьJSON(Чтение, Ложь);        Чтение.Закрыть();         // ... создаём документ по данным ...         Ответ.УстановитьТелоИзСтроки("{""status"":""ok""}");    Исключение        Ответ = Новый HTTPСервисОтвет(400);        Ответ.Заголовки.Вставить("Content-Type", "application/json; charset=utf-8");        Ответ.УстановитьТелоИзСтроки("{""error"":""bad json""}");    КонецПопытки;    Возврат Ответ;КонецФункции

Коды ответов, которые должен знать сайт

КодКогда возвращать
200Всё получилось, в теле — результат.
400Кривой JSON, нет обязательных полей.
404Не найден объект по идентификатору из URL.
500Внутренняя ошибка. Текст ошибки — в журнал, не клиенту.
Частая ошибка

Не отдавай клиенту ПодробноеПредставлениеОшибки — это внутренняя кухня базы. Клиенту короткий код ошибки, подробности в журнал регистрации.

Кодировка и пустое тело

Читай тело через ПолучитьТелоКакСтроку(КодировкаТекста.UTF8), если сайт может прислать кириллицу без указания кодировки. И проверяй пустое тело до чтения JSON — иначе получишь исключение на ровном месте.