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