Другое · 7 мин
Как подключиться к HTTP-сервису из 1С
Как настроить HTTP-соединение в 1С:Предприятии: адрес, порт, аутентификация, проверка ответа и типичные ошибки при интеграции с внешними сервисами.
Подключение к внешнему HTTP-сервису из 1С позволяет обмениваться данными с интернет-ресурсами, сервисами доставки, каталогами или собственными веб-приложениями. В конфигурации это реализуется через встроенный объект для работы с HTTP-соединениями, который открывает канал, отправляет запрос и получает ответ.
Перед началом настройки уточните адрес сервиса, используемый протокол, порт и способ аутентификации. Без этих данных невозможно корректно заполнить параметры соединения, а ошибка на этом этапе чаще всего становится причиной отказа в доступе или таймаута.
Что такое HTTP-соединение в 1С и когда оно нужно
HTTP-соединение в 1С используется, когда программа должна получить или передать данные по протоколу HTTP без участия пользователя в браузере. Типичные ситуации: выгрузка документов в сторонний сервис, получение справочника контрагентов, проверка статуса заказа или отправка уведомлений через веб-API.
Соединение создаётся программно в модуле конфигурации. После установки параметров адреса и порта открывается сеанс, формируется запрос с методом и заголовками, а затем считывается ответ. Если сервис требует авторизации, добавляются соответствующие учётные данные или токены.
Требования к адресу, порту и протоколу
Укажите полный адрес сервиса, включая схему подключения. Для защищённых каналов обычно применяется шифрованное соединение, для открытых — обычное. Порт зависит от настроек сервера и выбранного протокола; нестандартный порт указывается явно, если он отличается от значения по умолчанию.
Проверьте, что компьютер или сервер, на котором запущена 1С, имеет сетевой доступ к указанному адресу. Брандмауэр, прокси или ограничения провайдера могут блокировать исходящие запросы, даже если параметры в конфигурации введены верно.
- 1Укажите адрес сервиса, порт и протокол подключения
- 2Создайте объект HTTP-соединения и задайте необходимые заголовки
- 3Выполните запрос методом GET или POST
- 4Проверьте код ответа и содержимое тела
- 5При ошибке скорректируйте адрес, порт или учётные данные
Создание HTTP-соединения в конфигурации
Простой запрос без аутентификации
Создайте объект соединения, передав адрес и порт, затем выполните запрос методом GET или POST в зависимости от задачи. Для получения данных обычно достаточно GET, а для передачи формы или файла — POST с телом запроса и заголовком типа содержимого.
После отправки запроса получите ответ и проверьте его код. Успешный код означает, что сервер принял запрос, но не гарантирует корректность содержимого, поэтому полезно дополнительно анализировать тело ответа.
Запрос с аутентификацией и заголовками
Если сервис требует авторизации, укажите логин и пароль или добавьте заголовок с токеном. Некоторые сервисы ожидают специальные поля в заголовке запроса, например тип содержимого или идентификатор приложения. Отсутствие обязательного заголовка чаще всего приводит к ошибке доступа.
Учётные данные лучше хранить отдельно от программного кода, в защищённых настройках конфигурации. Не передавайте пароли открытым текстом в публичных модулях и не оставляйте их в истории изменений без необходимости.
Как проверить результат
Успешный код сервера
Ошибка соединения или отказ в доступе
Ожидаемые данные в нужном формате
Пустой ответ или сообщение об ошибке
Запрос доходит до сервиса
Таймаут или ошибка сети
Параметры аутентификации и заголовков
Заголовки позволяют сервису понять, какой формат данных ожидается и кто выполняет запрос. Часто используется указание типа содержимого, язык ответа и токен авторизации. Состав заголовков зависит от требований конкретного сервиса и описывается в его документации.
При использовании токена следите за его сроком действия. Истёкший токен вызывает ошибку авторизации, и соединение нужно обновить, запросив новый токен по правилам сервиса.
Проверка результата и обработка ответов
После выполнения запроса проверьте код состояния сервера. Успешный код подтверждает доставку запроса, но содержимое может содержать сообщение об ошибке внутри самого тела. Поэтому полезно читать текст ответа, а не только код.
Если ответ приходит в структурированном формате, его можно распарсить и использовать в расчётах, документах или справочниках. При некорректном формате или пустом ответе программа должна обработать ситуацию и вывести понятное сообщение пользователю.
Сравнение вариантов
Подходит для получения справочников и статусов, ограничен размером передаваемых данных
Подходит для отправки документов и файлов, требует правильного типа содержимого
Удобно для повторных вызовов, требует обновления истёкшего токена
Типичные ошибки и ограничения
Частые причины неудачи: неверный адрес или порт, блокировка брандмауэром, отсутствие обязательного заголовка, неверный формат даты или числа в теле запроса. Также возможны ограничения по количеству запросов в единицу времени со стороны сервиса.
Если соединение работает вручную из браузера, но не из 1С, причина может быть в сетевых настройках сервера 1С, отсутствии доверенных сертификатов или ином режиме работы подключения. В таких случаях целесообразно обратиться к администратору инфраструктуры.
Сравнение способов взаимодействия
Границы безопасной самостоятельной настройки
Настройка простого соединения с открытым сервисом может быть выполнена самостоятельно. Если речь идёт о передаче конфиденциальных данных, интеграции с платёжными системами или работе с личными данными пользователей, подключение лучше согласовывать с ответственным за информационную безопасность.
Не вносите изменения в рабочую базу без резервной копии и предварительной проверки на копии конфигурации. Ошибка в параметрах соединения может привести к остановке обмена или потере данных при выгрузке.
Что важно запомнить
Проверяйте адрес, порт и заголовки, контролируйте код ответа и не храните пароли в открытом коде.
Нужно ли специальное ПО для подключения к HTTP-сервису?
Обычно достаточно встроенных средств 1С:Предприятия для работы с HTTP-соединениями. Дополнительное ПО может потребоваться только при специфических требованиях к шифрованию или прокси.
Что делать, если сервер возвращает ошибку доступа?
Проверьте правильность адреса, порта и учётных данных, убедитесь, что отправлены все обязательные заголовки, и подтвердите, что учётная запись не заблокирована на стороне сервиса.
Можно ли использовать одно соединение для нескольких запросов?
Да, объект соединения можно использовать повторно в рамках сеанса, но после завершения работы его следует закрыть. При смене параметров авторизации может потребоваться создать соединение заново.
Как понять, что проблема в сети, а не в 1С?
Попробуйте открыть тот же адрес из браузера на том же компьютере. Если в браузере адрес недоступен, причина скорее всего в сети или на стороне сервиса, а не в настройках 1С.