К статье
Практический материал

Другое · 7 мин

Как подключиться к HTTP-сервису из 1С

Как настроить HTTP-соединение в 1С:Предприятии: адрес, порт, аутентификация, проверка ответа и типичные ошибки при интеграции с внешними сервисами.

Подключение к внешнему HTTP-сервису из 1С позволяет обмениваться данными с интернет-ресурсами, сервисами доставки, каталогами или собственными веб-приложениями. В конфигурации это реализуется через встроенный объект для работы с HTTP-соединениями, который открывает канал, отправляет запрос и получает ответ.

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

Что такое HTTP-соединение в 1С и когда оно нужно

HTTP-соединение в 1С используется, когда программа должна получить или передать данные по протоколу HTTP без участия пользователя в браузере. Типичные ситуации: выгрузка документов в сторонний сервис, получение справочника контрагентов, проверка статуса заказа или отправка уведомлений через веб-API.

Соединение создаётся программно в модуле конфигурации. После установки параметров адреса и порта открывается сеанс, формируется запрос с методом и заголовками, а затем считывается ответ. Если сервис требует авторизации, добавляются соответствующие учётные данные или токены.

Требования к адресу, порту и протоколу

Укажите полный адрес сервиса, включая схему подключения. Для защищённых каналов обычно применяется шифрованное соединение, для открытых — обычное. Порт зависит от настроек сервера и выбранного протокола; нестандартный порт указывается явно, если он отличается от значения по умолчанию.

Проверьте, что компьютер или сервер, на котором запущена 1С, имеет сетевой доступ к указанному адресу. Брандмауэр, прокси или ограничения провайдера могут блокировать исходящие запросы, даже если параметры в конфигурации введены верно.

Порядок действий
  1. 1
    Укажите адрес сервиса, порт и протокол подключения
  2. 2
    Создайте объект HTTP-соединения и задайте необходимые заголовки
  3. 3
    Выполните запрос методом GET или POST
  4. 4
    Проверьте код ответа и содержимое тела
  5. 5
    При ошибке скорректируйте адрес, порт или учётные данные

Создание HTTP-соединения в конфигурации

Простой запрос без аутентификации

Создайте объект соединения, передав адрес и порт, затем выполните запрос методом GET или POST в зависимости от задачи. Для получения данных обычно достаточно GET, а для передачи формы или файла — POST с телом запроса и заголовком типа содержимого.

После отправки запроса получите ответ и проверьте его код. Успешный код означает, что сервер принял запрос, но не гарантирует корректность содержимого, поэтому полезно дополнительно анализировать тело ответа.

Запрос с аутентификацией и заголовками

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

Учётные данные лучше хранить отдельно от программного кода, в защищённых настройках конфигурации. Не передавайте пароли открытым текстом в публичных модулях и не оставляйте их в истории изменений без необходимости.

Контрольные точки

Как проверить результат

Код состояния ответа
Норма

Успешный код сервера

Тревожный признак

Ошибка соединения или отказ в доступе

Тело ответа
Норма

Ожидаемые данные в нужном формате

Тревожный признак

Пустой ответ или сообщение об ошибке

Доступность адреса
Норма

Запрос доходит до сервиса

Тревожный признак

Таймаут или ошибка сети

Параметры аутентификации и заголовков

Заголовки позволяют сервису понять, какой формат данных ожидается и кто выполняет запрос. Часто используется указание типа содержимого, язык ответа и токен авторизации. Состав заголовков зависит от требований конкретного сервиса и описывается в его документации.

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

Типичные ошибки
01
Неверный адрес или порт приводит к ошибке соединения
02
Отсутствие нужного заголовка авторизации вызывает отказ в доступе
03
Игнорирование кода ответа маскирует неудачу обмена

Проверка результата и обработка ответов

После выполнения запроса проверьте код состояния сервера. Успешный код подтверждает доставку запроса, но содержимое может содержать сообщение об ошибке внутри самого тела. Поэтому полезно читать текст ответа, а не только код.

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

Сравнение вариантов

GET-запрос

Подходит для получения справочников и статусов, ограничен размером передаваемых данных

POST-запрос

Подходит для отправки документов и файлов, требует правильного типа содержимого

Соединение с токеном

Удобно для повторных вызовов, требует обновления истёкшего токена

Типичные ошибки и ограничения

Частые причины неудачи: неверный адрес или порт, блокировка брандмауэром, отсутствие обязательного заголовка, неверный формат даты или числа в теле запроса. Также возможны ограничения по количеству запросов в единицу времени со стороны сервиса.

Если соединение работает вручную из браузера, но не из 1С, причина может быть в сетевых настройках сервера 1С, отсутствии доверенных сертификатов или ином режиме работы подключения. В таких случаях целесообразно обратиться к администратору инфраструктуры.

Сравнение способов взаимодействия

Границы безопасной самостоятельной настройки

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

Не вносите изменения в рабочую базу без резервной копии и предварительной проверки на копии конфигурации. Ошибка в параметрах соединения может привести к остановке обмена или потере данных при выгрузке.

Итог

Что важно запомнить

Проверяйте адрес, порт и заголовки, контролируйте код ответа и не храните пароли в открытом коде.

Нужно ли специальное ПО для подключения к HTTP-сервису?

Обычно достаточно встроенных средств 1С:Предприятия для работы с HTTP-соединениями. Дополнительное ПО может потребоваться только при специфических требованиях к шифрованию или прокси.

Что делать, если сервер возвращает ошибку доступа?

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

Можно ли использовать одно соединение для нескольких запросов?

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

Как понять, что проблема в сети, а не в 1С?

Попробуйте открыть тот же адрес из браузера на том же компьютере. Если в браузере адрес недоступен, причина скорее всего в сети или на стороне сервиса, а не в настройках 1С.