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

Другое · 9 мин

Чем отличается веб-сервис от HTTP-сервиса в 1С

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

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

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

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

Что представляет собой веб-сервис в 1С

Веб-сервис в 1С публикуется через механизм веб-сервисов платформы и описывается языком WSDL. Внешний клиент может загрузить описание сервиса и сгенерировать классы для вызова операций, что упрощает разработку на стороне Java, C# или других сред с поддержкой SOAP.

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

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

Что представляет собой HTTP-сервис в 1С

HTTP-сервис в 1С предназначен для приёма и обработки входящих HTTP-запросов по заданным адресам. Он не всегда формирует WSDL и не требует от клиента строгого контракта, что делает его ближе к REST-подобным конечным точкам, хотя реализация зависит от конфигурации и релиза платформы.

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

Такой подход оправдан для простых уведомлений, приёма данных от устройств, работы с JSON, загрузки файлов или случаев, когда внешняя система не хочет или не может работать с WSDL и SOAP.

Главные отличия в публикации и контракте

Веб-сервис публикуется с явным описанием операций и типов, которое доступно клиентам через специальный адрес описания. HTTP-сервис публикуется как обработчик адресов, и клиент обычно узнаёт о допустимых запросах из документации или примеров, а не из автоматического контракта.

Отличия касаются также способа вызова: веб-сервис использует SOAP-конверт и строго определенные действия, а HTTP-сервис оперирует методами запроса, заголовками, телом и параметрами адреса. Это влияет на выбор библиотек на стороне клиента и на сложность отладки.

ПараметрВеб-сервисHTTP-сервис
Формальный контрактОбычно WSDLНе обязателен, часто отсутствует
Основной формат обменаSOAP/XMLJSON, XML, текст, файлы по ситуации
Генерация клиентского кодаВозможна автоматически по WSDLОбычно вручную или по документации
Гибкость структуры сообщенийОграничена контрактомВыше, определяется разработчиком
Сложность изменений интерфейсаВыше, требует синхронизации с клиентамиНиже, но риск несовместимости остаётся

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

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

Веб-сервис

Подходит для типизированной интеграции с формальным контрактом; ограничение — сложнее вносить необратимые изменения без обновления клиентов.

HTTP-сервис

Подходит для гибких конечных точек и нестандартных форматов; ограничение — нужна собственная документация и контроль версий вручную.

Форматы данных, вызовы и клиенты

Веб-сервисы в 1С чаще используют XML в SOAP-конверте. Это удобно для корпоративных систем, где важна строгая типизация, но делает сообщения объёмнее и требует поддержки SOAP-стека на стороне клиента.

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

При вызове веб-сервиса клиент обычно обращается к методу по имени из контракта. При вызове HTTP-сервиса клиент формирует адрес, метод, заголовки и тело, а 1С обрабатывает запрос в соответствии с правилами публикации. Отличие важно при выборе инструментов тестирования: для веб-сервиса подходят SOAP-клиенты, для HTTP-сервиса — обычные HTTP-клиенты и curl-подобные утилиты.

Безопасность, аутентификация и доступ

Оба типа сервисов могут размещаться на веб-сервере с использованием SSL/TLS, аутентификации пользователей 1С и прав доступа. Веб-сервис может использовать встроенные механизмы безопасности платформы, а HTTP-сервис требует внимательной проверки прав на каждый адрес и метод.

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

Порядок действий
  1. 1
    Опубликуйте сервис в тестовой конфигурации
  2. 2
    Получите адрес описания или конечной точки
  3. 3
    Выполните тестовый вызов и сверьте ответ
  4. 4
    Проверьте права доступа и аутентификацию
  5. 5
    Перенесите настройку в рабочую базу после согласования

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

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

Выбирайте веб-сервис, если внешняя система ожидает WSDL, нужна автоматическая генерация клиента и строгий контроль типов. Выбирайте HTTP-сервис, если важна простота адресов, работа с JSON, загрузка файлов или интеграция с системами без поддержки SOAP.

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

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

Адрес описания веб-сервиса
Норма

WSDL открывается и содержит ожидаемые операции

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

Страница недоступна или не содержит операций

HTTP-сервис
Норма

Тестовый запрос возвращает ожидаемый код и тело

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

Сервер возвращает ошибку доступа или пустой ответ

Права доступа
Норма

Доступ только у авторизованных пользователей

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

Доступен без аутентификации извне

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

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

Одна из частых ошибок — публикация веб-сервиса без учёта того, что изменение операции ломает сгенерированные клиентские классы. Другой вариант — использование HTTP-сервиса без документации, из-за чего новые разработчики не понимают, какие поля передавать.

Типичные ошибки
01
Публикация веб-сервиса без согласования изменений контракта с клиентами
02
Открытие HTTP-сервиса без проверки аутентификации и прав доступа
03
Использование отладочных адресов и тестовых данных в продакшене

Не смешивайте понятия «веб-сервис» и «любой сервис по HTTP». Наличие HTTP не делает сервис веб-сервисом в терминологии 1С. Также не публикуйте отладочные версии с широкими правами в рабочей среде.

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

Итог

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

Веб-сервис — строгий контракт и WSDL, HTTP-сервис — гибкие HTTP-запросы без обязательного автоматического описания. Выбирайте по задаче, проверяйте права и тестируйте в копии базы.

Нужно ли всегда использовать WSDL для интеграции с 1С?

Нет. WSDL характерен для веб-сервисов, но многие интеграции удобнее реализовать через HTTP-сервис с JSON, особенно если клиент не поддерживает SOAP или требуется простой обмен данными.

Можно ли заменить веб-сервис на HTTP-сервис без переработки клиента?

Обычно нет. Клиент, ожидающий SOAP и WSDL, не сможет автоматически работать с произвольным HTTP-сервисом. Потребуется изменить код клиента, адреса, форматы запросов и обработку ответов.

Как проверить, опубликован ли сервис корректно?

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

Какие риски при публикации HTTP-сервиса?

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

Что делать, если клиент не может сгенерировать классы по веб-сервису?

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