Общая информация

Одним из распространенных способов взаимодействия приложений в Интернете является использование веб-сервисов. Одно приложение (поставщик веб-сервиса) публикует свой веб-сервис по уникальному веб-адресу в Интернете, а другие приложения (потребители веб-сервиса) могут обратиться к этому веб-сервису, для того чтобы получить какие-то данные от поставщика, передать ему какие-то данные или заставить поставщика выполнить какие-то действия.

Существуют разные протоколы и разные архитектуры, с помощью которых реализуются веб-сервисы. В платформе поддерживается работа с двумя видами веб-сервисов: веб-сервисы, реализованные в архитектуре REST (в «1С:Предприятии» они называются HTTP-сервисы), и веб-сервисы, работающие по протоколу SOAP (в «1С:Предприятии» они называются Web-сервисы).

В этом разделе мы будем рассматривать HTTP-сервисы (REST) как наиболее популярные и часто используемые. Про Web-сервисы (SOAP) вы можете прочитать далее, в разделе «».

Не вдаваясь в технические подробности, можно сказать, что HTTP-сервисы пользуются популярностью благодаря следующим качествам:

• простота программирования клиента таких сервисов;
• потенциально меньший объем передаваемых данных;
• потенциально меньшая вычислительная нагрузка;
• HTTP-сервисы ориентированы на «ресурсы», в то время как SOAP-сервисы ориентированы на «действия».

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

Обращение к HTTP-сервису выполняется по некоторому URL. В качестве примера можно привести HTTP-сервис, который при обращении по одному URL возвращает список каких-либо документов (например, расходных накладных), а при обращении по другому URL возвращает конкретную накладную. Действие, которое следует выполнить серверу, определяется тем, какой HTTP-метод адресован серверу. Например, если на сервер отправляется GET-запрос, то выполняется получение каких-либо данных, DELETE-запрос приводит к удалению данных и т. д.

При реализации HTTP-сервиса прикладной разработчик должен определить следующие элементы сервиса:

• Базовую часть URL, по которому будет выполняться обращение к сервису.
• Состав предоставляемой функциональности и структуру ресурсов, на которых эта функциональность будет отображаться.
• Действия (HTTP-методы), которые можно будет выполнить при обращении к тому или иному ресурсу.
• Для каждого выбранного действия разработчик должен создать специальный метод, написанный на встроенном языке платформы «1С:Предприятие», который и реализует необходимую функциональность. Метод располагается в специальном модуле, связанном с HTTP-сервисом.

После реализации HTTP-сервиса необходимо опубликовать его на веб-сервере с помощью стандартного механизма публикации.

Для обращения к HTTP-сервису нужно сформировать URL, который в общем виде выглядит следующим образом: http://host/base/hs/<корневойURL>/<относительныйURL>. Рассмотрим более подробно составные части адреса:

• http://host/base – это обычный URL, по которому выполняется доступ, например, к информационной базе с помощью веб-клиента. Необходимо помнить, что при использовании информационной базы, в которой настроено разделение данных, значения разделителей можно указывать только в URL информационной базы. Указание разделителей с помощью параметра Z не поддерживается;
• hs – признак того, что выполняется обращение к HTTP-сервису (в отличие от ws, который определяет доступ к Web-сервису);
• <корневойURL> – имя ресурса, которое определяет группу ресурсов, связанных общим смыслом. Задается в свойстве КорневойURL объекта HTTP-сервис;
• <относительныйURL> – определяет ресурс, к которому будет выполняться обращение. Относительный URL, указанный в запросе, будет использован для определения конкретного ресурса, к которому выполняется обращение. Правило сопоставления задается в свойстве Шаблон объекта Шаблон URL, подчиненного объекту HTTP-сервис.

подробнее

Более подробно HTTP-сервисы описаны в докуменации «1С:Предприятия 8» в разделе «Глава 17. Механизмы интернет-сервисов – HTTP-сервисы – HTTP-сервисы».

Отправить