Параметры HTTP-запроса в 1С: URL, заголовки, тело, GET и POST

Из чего состоит запрос: HTTPСоединение, HTTPЗапрос и URL

Параметры HTTP-запроса в 1С разнесены по двум объектам, и это первое, что путает при интеграции:

• HTTPСоединение — параметры канала связи: сервер, порт, пользователь/пароль (Basic Auth), прокси, таймаут, защищённое соединение (HTTPS). Один объект соединения переиспользуется для всех запросов к одному хосту.
• HTTPЗапрос — параметры конкретного обращения: путь ресурса (без хоста!), заголовки, тело. Создаётся отдельно для каждого вызова.
• HTTPОтвет — результат: код состояния, заголовки ответа, тело (строка или двоичные данные).

HTTP-метод (GET, POST, PUT, DELETE) в объекты не входит — он передаётся отдельным аргументом в ВызватьHTTPМетод().

Полный URL https://api.example.com:443/v2/orders/42 в 1С разбивается на две части. Сервер, порт и признак HTTPS уходят в конструктор HTTPСоединение, а путь после хоста (/v2/orders/42) — в HTTPЗапрос.АдресРесурса:

Соединение = Новый HTTPСоединение(
    "api.example.com",   // сервер БЕЗ схемы и без пути
    443,                 // порт
    ,                    // Пользователь (Basic Auth)
    ,                    // Пароль
    ,                    // Прокси
    30,                  // Таймаут, сек
    Новый ЗащищенноеСоединениеOpenSSL()  // HTTPS
);

Запрос = Новый HTTPЗапрос("/v2/orders/42");
Ответ = Соединение.ВызватьHTTPМетод("GET", Запрос);

Частая ошибка: указать сервер как "https://api.example.com/v2/". Платформа не разберёт эту строку — схема задаётся отдельным параметром ЗащищенноеСоединение, а путь идёт в HTTPЗапрос.

GET-параметры (строка запроса): передать значения в 1С HTTP-запрос

Строка запроса (?a=1&b=2) — часть АдресРесурса, а не отдельный параметр объекта. Все значения обязательно кодируются функцией КодироватьСтроку() со способом СпособКодированияСтроки.КодировкаURL:

Параметры = Новый Соответствие;
Параметры.Вставить("q", "накладная №5");
Параметры.Вставить("limit", "20");

Части = Новый Массив;
Для Каждого КЗ Из Параметры Цикл
    Ключ = КодироватьСтроку(КЗ.Ключ, СпособКодированияСтроки.КодировкаURL);
    Значение = КодироватьСтроку(КЗ.Значение, СпособКодированияСтроки.КодировкаURL);
    Части.Добавить(Ключ + "=" + Значение);
КонецЦикла;

Путь = "/api/search?" + СтрСоединить(Части, "&");
Запрос = Новый HTTPЗапрос(Путь);
Ответ = Соединение.ВызватьHTTPМетод("GET", Запрос);

Что даёт КодировкаURL: пробел превращается в %20, кириллица — в последовательность байтов UTF-8 (%D0%9E и т.д.), спецсимволы (& = ? #) — в свои процент-коды. Без кодирования сервер получит битые параметры или ответит 400 Bad Request.

Не путайте КодировкаURL с КодировкаURLВПараметре: вторая дополнительно кодирует зарезервированные символы +, /, = — используйте её именно для значений, если сервис их не разбирает.

Заголовки HTTP-запроса в 1С: Content-Type, Authorization, Accept

Заголовки HTTP-запроса в 1С хранятся в свойстве HTTPЗапрос.Заголовки — это Соответствие (ключ и значение — строки). Задавайте заголовки до вызова ВызватьHTTPМетод():

Запрос = Новый HTTPЗапрос("/api/orders");
Запрос.Заголовки.Вставить("Content-Type", "application/json; charset=utf-8");
Запрос.Заголовки.Вставить("Accept", "application/json");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + Токен);
Запрос.Заголовки.Вставить("User-Agent", "1C:Enterprise/8.3");

Ключевые заголовки, которые придётся выставлять в интеграциях:

• Content-Type — формат тела. Для JSON — application/json; charset=utf-8, для форм — application/x-www-form-urlencoded, для XML — application/xml. Платформа сама этот заголовок не проставляет.
• Authorization — Bearer <токен> для OAuth/JWT. Для Basic-аутентификации проще передать пользователя и пароль в конструктор HTTPСоединение — платформа сама сформирует заголовок.
• Accept — какой формат ответа ждём.
• Content-Length — не задавайте вручную. Платформа посчитает длину тела сама и подставит правильное значение.

Тело HTTP-запроса в 1С: строка, JSON, двоичные данные

Тело выставляется после создания HTTPЗапрос, до вызова HTTP-метода. Для текстовых форматов (JSON, XML, form-urlencoded) — УстановитьТелоИзСтроки(), для файлов и произвольных бинарных данных — УстановитьТелоИзДвоичныхДанных():

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Новый Структура("order_id, sum", 42, 1500));
ТелоСтрокой = ЗаписьJSON.Закрыть();

Запрос = Новый HTTPЗапрос("/api/orders");
Запрос.Заголовки.Вставить("Content-Type", "application/json; charset=utf-8");
Запрос.УстановитьТелоИзСтроки(
    ТелоСтрокой,
    КодировкаТекста.UTF8,
    ИспользованиеByteOrderMark.НеИспользовать  // BOM в HTTP-теле не нужен
);

Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос);

Для файлов и произвольных бинарных данных:

Данные = Новый ДвоичныеДанные("C:\temp\invoice.pdf");
Запрос = Новый HTTPЗапрос("/api/upload");
Запрос.Заголовки.Вставить("Content-Type", "application/pdf");
Запрос.УстановитьТелоИзДвоичныхДанных(Данные);

Для формы (application/x-www-form-urlencoded) тело собирается так же, как GET-параметры: key=value&key2=value2 с процент-кодированием, но уходит в тело, а не в URL.

GET и POST: где хранить параметры

В 1С разница между GET и POST — только в аргументе метода ВызватьHTTPМетод() и в том, куда попадают параметры:

• GET — параметры только в URL (АдресРесурса после ?). Тела у GET-запроса быть не должно; многие серверы игнорируют тело в GET, а прокси могут его вырезать.
• POST/PUT/PATCH — параметры в теле; путь может содержать только идентификатор ресурса (/api/orders/42). Обязательно Content-Type, иначе сервер не поймёт формат тела.
• DELETE — обычно только путь, без тела и без параметров.

Один и тот же объект HTTPЗапрос можно передать в разные вызовы ВызватьHTTPМетод("GET", …) и ВызватьHTTPМетод("POST", …) — метод задаётся снаружи.

HTTPОтвет: код состояния, заголовки и разбор тела

ВызватьHTTPМетод() возвращает объект HTTPОтвет. Проверяйте сначала КодСостояния, потом читайте тело:

Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос);

Если Ответ.КодСостояния >= 200 И Ответ.КодСостояния < 300 Тогда
    ТелоОтвета = Ответ.ПолучитьТелоКакСтроку();  // UTF-8 по умолчанию
    // разбор JSON…
ИначеЕсли Ответ.КодСостояния = 401 Тогда
    ВызватьИсключение "Не авторизован: проверь токен";
ИначеЕсли Ответ.КодСостояния = 400 Тогда
    ВызватьИсключение "Плохой запрос: " + Ответ.ПолучитьТелоКакСтроку();
Иначе
    ВызватьИсключение "HTTP " + Ответ.КодСостояния;
КонецЕсли;

Важно: ВызватьHTTPМетод() не бросает исключение при ошибке HTTP — 401 и 500 приходят как обычный ответ, а не как ошибка платформы. Исключение возникнет только при сетевой проблеме (не резолвится хост, таймаут, сертификат) — вот его как раз имеет смысл ловить через Попытка.

Частые ошибки при сборе HTTP-запроса в 1С

• Схема https:// в имени сервера. HTTPСоединение ждёт хост без схемы. HTTPS включается объектом ЗащищенноеСоединениеOpenSSL() в конструкторе.
• GET-параметры без кодирования. Кириллица, пробелы и & в значении ломают строку запроса. Всегда прогоняйте значения через КодироватьСтроку(…, СпособКодированияСтроки.КодировкаURL).
• Забыли Content-Type. Без заголовка сервер не знает, как разобрать тело POST-запроса, и отвечает 400/415. Платформа заголовок сама не проставляет.
• BOM в теле. Если УстановитьТелоИзСтроки() вызвать с ИспользованиеByteOrderMark.Использовать, JSON начнётся с невидимых байтов EF BB BF, и парсер на стороне сервиса упадёт с «неожиданным символом». Для HTTP-тела BOM всегда не используется.
• Проверка результата через Попытка. HTTP-ошибки (401, 404, 500) — не исключения платформы. Их нужно проверять по Ответ.КодСостояния, а не ловить.
• Тело в GET-запросе. Формально можно, но многие сервисы и прокси его игнорируют. Параметры GET кладите в URL.
• Одноразовое соединение под каждый запрос в цикле. На массовых обращениях к одному хосту создавайте HTTPСоединение один раз и переиспользуйте — сэкономите TLS-handshake.

Частые вопросы о параметрах HTTP-запроса в 1С