--- title: "Working with SOAP and XML APIs" slug: "working-with-soap-and-xml-apis" updated: 2023-10-31T16:20:34Z published: 2023-10-31T16:20:34Z canonical: "support.tulip.co/working-with-soap-and-xml-apis" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Работа с SOAP и XML API ## Обзор *Руководство с советами и рекомендациями по работе с API на основе XML* [Коннекторы Tulip Connectors](https://support.tulip.co/docs/an-overview-of-http-connectors) могут использоваться для взаимодействия со многими типами внешних источников данных. Данная статья посвящена HTTP API, которые обмениваются информацией с использованием [XML](https://en.wikipedia.org/wiki/XML). В эту категорию входят и [SOAP](https://en.wikipedia.org/wiki/SOAP) API. ## Отправка XML-данных в Tulip Для отправки XML-содержимого в теле запроса используйте нотацию `$value$`, чтобы показать, что необходимо вставить параметр. Например, в поле Request Body (Тело запроса) указано следующее: ``` xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mes="http://mes.myexample.com" xmlns:get="http://getInfo.mes.myexample.com" > > > > > > > > > > $input1$ > > $input2$ > > > > > > > > > ``` > > > и значения `input1` и `input2` в качестве входных данных для функции-коннектора, формируется запрос с подставленными в тело запроса значениями `input1` и `input2`. Это показано в интерфейсе Tulip Connector Function ниже: ![Working with SOAP and XML APIs_229803470.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Working%20with%20SOAP%20and%20XML%20APIs_229803470.png){height="" width=""} ## Разбор XML-данных в Tulip ### Простой пример API Начнем с простого примера ответа от XML API. ``` xml version="1.0" encoding="UTF-8"? Повседневная итальянская кухня Джада Де Лаурентис 2005 30.00 Гарри Поттер Дж. К. Роулинг 2005 29.99 Изучаем XML Эрик Т. Рэй 2003 39.95 ``` Следующие примеры показывают, как получить доступ к различным частям информации в Tulip. Извлекатель из: `/bookstore/book[1]/title` возвращает: `Повседневный итальянский.` Обратите внимание, что массивы в XML "1-индексированы", т.е. первый элемент находится в позиции "1", в отличие от {{glossary.JSON}}-запроса, который "0-индексирован". Экстрактор из: `/bookstore/book[1]/title/text()` возвращает: `Everyday Italian` Обратите внимание, что функция `/text()` используется для извлечения текстового значения, содержащегося в выбранном узле. Экстрактор из: `/bookstore/book[@category="children"][1]/title/text()` возвращает: `Гарри Поттер` Обратите внимание, что селектор позволил нам осуществлять поиск внутри свойств узла. Эти примеры могут быть непосредственно использованы в Tulip, как показано ниже: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Working%20with%20SOAP%20and%20XML%20APIs_229776239.png) ### Пример SOAP API Теперь рассмотрим более сложный случай с использованием пространств имен, характерных для SOAP API. ``` > > > > > > > > > 0 > > > > > > информация получена успешно > > > > > > > > Моя операция > > Нет > > 1234567-890 > > B > > > > > > > > PartNumber > > 1234567-890 > > > > > > PartRevision > > B > > > > > > PartDescription > > Мой пример детали > > > > > > > > Обычный > > > > > > > > > > > > > ``` > > > В этом ответе используются пространства имен XML, что создает дополнительные сложности. В большинстве случаев глобальный поиск с использованием операторов `//*` и `.//*` делает извлечение очень простым. Экстрактор из: `//*[local-name()="propertyName"][1]/text()` возвращает: `PartNumber .` Обратите внимание, что массивы в XML "1-индексированы", т.е. первый элемент находится в позиции "1", в отличие от json-запроса, который "0-индексирован". Экстрактор из: `//*[local-name()="Property"]` возвращает: ` PartNumber 1234567-890 PartRevision B PartDescription Мой пример части ` Обратите внимание, что пространства имен "спускаются" в этот результат. Поэтому в подзапросе все равно будет выполняться поиск в глобальном пространстве имен. Чтобы извлечь массив объектов, используйте глобальный поиск, показанный в предыдущем примере, для извлечения массива, а затем экстрактор локального поиска вида: `.//*[local-name()="propertyName"]/text()` для получения массива объектов вида: `[ { "Name": "PartNumber" "Value": "1234567-890" }, { "Name": "PartRevision" "Value": "B" }, { "Name": "PartDescription". "Value": "Мой пример части" } ]` Эти примеры показаны в интерфейсе Tulip Connectors ниже: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Working%20with%20SOAP%20and%20XML%20APIs_229781522.png) --- Вы нашли то, что искали? Вы также можете зайти на [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all), чтобы задать свой вопрос или узнать, сталкивались ли другие с подобным вопросом! ```