---
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 ниже:
{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, как показано ниже:

### Пример 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 ниже:

---
Вы нашли то, что искали?
Вы также можете зайти на [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all), чтобы задать свой вопрос или узнать, сталкивались ли другие с подобным вопросом!
```