Веб-сервисы и HTTP-сервисы 1С на Apache и IIS: от конфигуратора до первого ответа

Чтобы опубликовать веб-сервис в 1С, нужны три вещи: сервис в конфигурации (Общие → Web-сервисы или Общие → HTTP-сервисы), установленный веб-сервер (Apache или IIS) с модулем расширения 1С и публикация базы через Администрирование → Публикация на веб-сервере в конфигураторе. После этого SOAP-сервис отвечает по адресу http://сервер/база/ws/..., а HTTP-сервис — по адресу http://сервер/база/hs/....

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

1. Что выбрать и что подготовить до публикации

В 1С 8.3 есть два механизма, и путают их постоянно.

Если внешняя сторона прислала WSDL — делайте web-сервис. Если интегратор говорит «дайте API на JSON» — HTTP-сервис.

Подготовка на сервере:

• 🧩 Модули расширения веб-сервера. При установке платформы отметьте компонент «Модули расширения веб-сервера». Без него в каталоге bin нет файлов wsap24.dll (Apache 2.4) и wsisapi.dll (IIS).
• 🖥️ Веб-сервер. Apache 2.4 или IIS с компонентом «Расширения ISAPI». На Linux — Apache, модуль лежит в /opt/1cv8/x86_64/<версия>/wsap24.so.
• ⚖️ Разрядность. Модуль 1С и веб-сервер должны быть одной разрядности: 64-битный Apache не загрузит 32-битный wsap24.dll.
• 🔢 Версия. Модуль берётся из той версии платформы, которой публикуете. После обновления платформы публикацию нужно обновить — путь к модулю в httpd.conf указывает на старую папку.

2. Создание HTTP-сервиса и веб-сервиса в конфигураторе

Работайте в копии конфигурации или в расширении. Для типовой конфигурации на поддержке удобнее расширение: основная конфигурация не снимается с поддержки, обновления ставятся без сравнения.

HTTP-сервис за пять шагов

1. В дереве конфигурации откройте Общие → HTTP-сервисы и добавьте новый объект, например API.
2. Заполните Корневой URL, например api. Это часть адреса после /hs/.
3. На вкладке шаблонов добавьте шаблон URL /v1/orders/{number}. Фигурные скобки — параметр.
4. Внутри шаблона добавьте метод GET и создайте для него обработчик (кнопкой открытия у поля «Обработчик» — конфигуратор сам создаст функцию в модуле сервиса).
5. Выполните Обновить конфигурацию базы данных (F7).

Обработчик получает объект HTTPСервисЗапрос и обязан вернуть HTTPСервисОтвет:

Функция OrdersGET(Запрос)

    НомерЗаказа = Запрос.ПараметрыURL.Получить("number");

    Если Не ЗначениеЗаполнено(НомерЗаказа) Тогда
        Возврат Новый HTTPСервисОтвет(400);
    КонецЕсли;

    Данные = Новый Структура("number, status", НомерЗаказа, "found");

    ЗаписьJSON = Новый ЗаписьJSON;
    ЗаписьJSON.УстановитьСтроку();
    ЗаписатьJSON(ЗаписьJSON, Данные);

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

    Возврат Ответ;

КонецФункции

Последний параметр УстановитьТелоИзСтроки убирает метку BOM в начале ответа. Многие JSON-парсеры на PHP и JavaScript спотыкаются о неё и сообщают о невалидном JSON, хотя глазами всё выглядит правильно.

Для POST тело запроса читают через Запрос.ПолучитьТелоКакСтроку(), а затем разбирают ЧтениеJSON и ПрочитатьJSON.

Web-сервис (SOAP)

1. Сначала создайте пакет XDTO в Общие → XDTO-пакеты, если операция возвращает сложный тип. Для простых значений (строка, число, булево) хватит стандартных типов xs:string, xs:decimal, xs:boolean.
2. В Общие → Web-сервисы добавьте сервис. Заполните URI пространства имён (например, http://example.local/stock), на вкладке «Прочее» укажите Имя файла публикации, например stock.1cws.
3. Добавьте операцию, задайте тип возвращаемого значения и параметры с их типами.
4. Откройте процедуру операции и напишите код. Это обычная функция модуля сервиса, её параметры совпадают с параметрами операции.

Функция ПолучитьОстаток(Артикул)
    // Здесь запрос к регистру остатков по артикулу
    Возврат 0;
КонецФункции

После обновления базы WSDL будет доступен по адресу http://сервер/база/ws/stock.1cws?wsdl.

3. Права пользователя и роли для веб-сервисов 1С

Сервис выполняется от имени пользователя информационной базы, под которым внешняя система авторизовалась. Отсюда три правила.

Отдельный пользователь под интеграцию. Не отдавайте интегратору логин бухгалтера или администратора. Создайте служебного пользователя: в типовых конфигурациях это Администрирование → Настройки пользователей и прав → Пользователи.

Отдельная роль. Создайте в конфигурации или расширении роль ИспользованиеAPI и дайте ей права ровно на те объекты, которые читает и пишет обработчик: «Чтение» на справочник номенклатуры, «Чтение» на регистр остатков, «Добавление» и «Изменение» на документ заказа. Флаг «Устанавливать права для новых объектов» не ставьте.

Привилегированный режим — точечно. Если обработчику нужно прочитать данные, которые пользователю видеть нельзя (например, константу с настройками), оберните это место в УстановитьПривилегированныйРежим(Истина) и сразу верните Ложь. Выдавать сервисному пользователю «Полные права» ради одного запроса — плохая идея: при утечке пароля злоумышленник получит всю базу.

Способы аутентификации:

4. Публикация веб-сервиса на веб-сервере: Apache, IIS и webinst

Через конфигуратор

1. Запустите конфигуратор от имени администратора Windows — иначе он не сможет записать httpd.conf или настройки IIS.
2. Откройте Администрирование → Публикация на веб-сервере.
3. Укажите Имя публикации (оно станет частью адреса, лучше латиницей: trade), выберите веб-сервер и Каталог, где будет лежать default.vrd.
4. На вкладке «Web-сервисы» отметьте «Публиковать Web-сервисы по умолчанию» или конкретные сервисы. На вкладке «HTTP сервисы» — «Публиковать HTTP сервисы по умолчанию». Для сервисов из расширения отдельно отметьте «Публиковать HTTP сервисы расширений по умолчанию».
5. Нажмите «Опубликовать». Для Apache конфигуратор предложит перезапустить службу — соглашайтесь.

Проверка: откройте в браузере http://localhost/trade/hs/api/v1/orders/123. Браузер запросит логин и пароль служебного пользователя и покажет JSON.

Через webinst без конфигуратора

На Linux и на серверах без графического сеанса публикуют утилитой webinst из каталога bin платформы:

sudo /opt/1cv8/x86_64/8.3.25.1374/webinst -publish -apache24 \
  -wsdir trade \
  -dir /var/www/trade \
  -connstr "Srvr=srv1c;Ref=trade;" \
  -confpath /etc/apache2/apache2.conf

Подставьте свою версию платформы. Параметр -connstr для файловой базы выглядит как File=/srv/bases/trade;. После публикации перезапустите Apache: sudo systemctl restart apache2.

Откройте созданный default.vrd и проверьте, что внутри элемента point есть строка разрешения HTTP-сервисов. Если её нет, а сервисы отвечают 404, добавьте:

<httpServices publishByDefault="true"/>

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

Файловая база и права каталогов

Для файловой базы веб-сервер работает с файлом 1Cv8.1CD напрямую. Учётной записи, от которой запущен Apache (www-data на Linux) или пул IIS (IIS_IUSRS), нужны права на чтение и запись каталога базы и на чтение каталога bin платформы. Без них — ошибка 500 при первом же запросе.

5. Диагностика ошибок публикации и журналы

Начинайте с кода ответа: он сразу сужает круг поиска.

Где смотреть подробности:

• 📒 Журнал регистрации базы. Ошибки выполнения кода сервиса попадают туда с именем служебного пользователя. Отфильтруйте журнал по этому пользователю.
• 📄 Лог веб-сервера. У Apache — error.log (на Linux обычно /var/log/apache2/error.log), у IIS — каталог inetpub\logs\LogFiles. Там видно, дошёл ли запрос до модуля 1С.
• 🔍 Технологический журнал. Для разбора медленных или «пропадающих» запросов включите его через logcfg.xml с событиями EXCP (исключения) и VRSREQUEST, VRSRESPONSE (входящие запросы и ответы). Технологический журнал быстро растёт, отключайте его после разбора.
• ✍️ Своё логирование. В начале обработчика пишите в журнал входящий URL и ключевые параметры через ЗаписьЖурналаРегистрации("API.Заказы", УровеньЖурналаРегистрации.Информация, , , Запрос.ОтносительныйURL). Через месяц, когда интегратор скажет «мы отправляли, а вы не приняли», будет чем ответить.

Для ручной проверки удобен curl:

curl -i -u api_shop:пароль "http://srv/trade/hs/api/v1/orders/123"

Ключ -i показывает заголовки ответа: сразу видно код, Content-Type и кодировку. Для SOAP-сервисов используйте SoapUI: он загружает WSDL и сам строит шаблон запроса.

6. Производительность веб-сервисов: сеансы, ответы, нагрузка

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

Что помогает:

1. Повторное использование сеансов. В свойствах HTTP-сервиса есть параметр «Повторное использование сеансов» и «Время жизни сеанса». Значение «Использовать» оставляет сеанс открытым между вызовами, клиент получает cookie и следующий запрос идёт в тот же сеанс. Клиенту нужно уметь хранить cookie — проверьте это у интегратора.
2. Лёгкий обработчик. Не вызывайте внутри сервиса проведение длинных документов синхронно. Принимайте данные, записывайте их в регистр сведений или очередь и отвечайте 202 Accepted. Обработку делайте регламентным заданием.
3. Запросы вместо объектов. Чтение через Запрос с выборкой нужных полей быстрее, чем Справочники.Номенклатура.НайтиПоКоду(...).ПолучитьОбъект() с загрузкой всех реквизитов и табличных частей.
4. Пагинация. Список из 50 000 позиций одним ответом повесит и 1С, и клиента. Добавьте в шаблон параметры limit и offset (читаются через Запрос.ПараметрыЗапроса) и отдавайте порциями по 500–1000 записей.
5. Клиент-серверный режим. Файловая база под постоянной нагрузкой от сервисов начинает ловить блокировки при одновременной работе пользователей. Если вызовов больше нескольких в минуту — переходите на сервер 1С.

7. Частые вопросы о публикации сервисов 1С