HTTP-сервисы 1С: как открыть API учётной системы

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

HTTP-сервисы

HTTP-сервис — объект конфигурации, в котором программист описывает собственный API: адреса, методы, обработку запросов. Например, GET-запрос по адресу остатков возвращает остатки товара в JSON, а POST по адресу заказов создаёт заказ клиента в базе. Программист сам решает, какие данные отдавать, в каком формате и с какими проверками.

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

Стандартный интерфейс OData

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

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

Веб-сервисы SOAP

Более старый механизм: обмен XML-сообщениями по описанию WSDL. Используется, когда внешняя система работает именно с SOAP, например некоторые корпоративные и государственные системы. Для новых интеграций обычно выбирают HTTP-сервисы.

Публикация на веб-сервере

Чтобы API был доступен извне, информационную базу публикуют на веб-сервере — например, Apache или IIS — с помощью средств платформы. После публикации у HTTP-сервисов, OData и веб-сервисов появляются адреса. Доступ из интернета нужно открывать только через HTTPS и, по возможности, ограничивать по адресам или через промежуточный шлюз.

Авторизация и права

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

Производительность

Каждый запрос к API занимает ресурсы сервера 1С. Если сайт при каждом открытии страницы спрашивает остатки напрямую у 1С, база начнёт тормозить у бухгалтеров. Решение — промежуточный слой: данные периодически выгружаются в кэш или отдельную базу сайта, а в 1С идут только запросы на запись, например создание заказа.

Промежуточный сервис

Хорошая практика — не открывать 1С напрямую в интернет, а поставить между ней и внешними системами отдельный сервис. Он принимает запросы, проверяет их, обращается к 1С по внутренней сети, кэширует данные, ведёт журнал. Так 1С остаётся в защищённом контуре, а внешние системы работают с понятным и стабильным API.

Обновления конфигурации

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