HTTP-запросы

В этом разделе рассказывается о том, как из системы «1С:Предприятие» можно обратиться к любому произвольному HTTP-сервису, опубликованному в Интернете, а также как обратиться к REST-интерфейсу любой внешней системы, доступному по протоколу OData.

Для простоты мы покажем примеры обращения к HTTP-сервисам и REST-интерфейсу (OData) прикладного решения «1С:Предприятия», реализованные нами в той же демонстрационной конфигурации, что и сами сервисы.

Ниже мы рассмотрим примеры получения, удаления и добавления данных прикладного решения «1С:Предприятия» с помощью HTTP-сервисов, разработанных нами в предыдущем разделе «». А затем изменение данных прикладного решения через REST-интерфейс (OData), который будет рассматриваться в следующем разделе «».

подробнее

Подробнее познакомиться с реализацией и использованием HTTP-запросов можно в демонстрационной конфигурации «Примеры работы», которая прилагается к книге.

Для обращения к HTTP-сервисам и REST-интерфейсу (OData) используются такие объекты встроенного языка, как HTTPСоединение, HTTPЗапрос и HTTPОтвет.

• Объект HTTPСоединение предназначен для взаимодействия с внешними системами по протоколу HTTP. В том числе с помощью объекта HTTPСоединение можно:
  • создать HTTP-соединение;
  • записать, получить и удалить файл;
  • отправить ресурс на указанный адрес для обработки;
  • определить параметры установленного соединения;
  • вызвать произвольный HTTP-метод;
  • передать на сервер заголовки запроса и получить заголовки с сервера;
  • в качестве тела запроса отправить не только файл, но и строку (с автоматическим перекодированием в нужную кодировку), и двоичные данные.
• Объект HTTPЗапрос предназначен для описания HTTP-запросов, отправляемых через объект HTTPСоединение. Позволяет задать адрес запрашиваемого ресурса, заголовки и тело запроса.
• Объект HTTPОтвет – предоставляет доступ к содержимому ответа HTTP-сервера на запрос.

Для того чтобы изменить (добавить, удалить, прочитать и т. д.) данные информационной базы через REST-интерфейс, нужно создать HTTP-соединение с сервером (например, "localhost"), на котором опубликованы HTTP-сервисы (как созданные разработчиком, так и составляющие автоматический REST-интерфейс) для прикладного решения. Затем создать HTTP-запрос на основе адреса ресурса данных, которые требуется прочитать или изменить с помощью запроса. После этого нужно записать изменяемые данные в строку JSON/XML (или в файл, откуда будет считано тело запроса при отправке) и установить тело HTTP-запроса из этой строки (или установить имя файла тела запроса). И затем с помощью HTTP-соединения отправить запрос к серверу с соответствующим методом (POST, PUT/PATCH, DELETE и др.).

Чтобы выполнить HTTP-запрос нужного вида, у объекта HTTPСоединение существуют методы:

• Получить() – отправляет GET-запрос на сервер;
• ОтправитьДляОбработки() – отправляет POST-запрос на сервер;
• Изменить() – отправляет PATCH-запрос на сервер;
• Записать() – отправляет PUT-запрос на сервер;
• Удалить() – отправляет DELETE-запрос на сервер;
• с помощью метода ВызватьHTTPМетод() можно отправить на сервер произвольный запрос, выполняющий HTTP-метод, имя которого указано в первом параметре метода ВызватьHTTPМетод().

Ниже для ознакомления приведен пример POST-запроса в формате atom/XML, с помощью которого создается новый элемент справочника Товары (листинг 1.74).

Листинг 1.74. POST-запрос в формате atom

Тот же запрос в формате json выглядит гораздо компактнее (листинг 1.75).

Листинг 1.75. POST-запрос в формате json

Отправить