---
title: "Working with SOAP and XML APIs"
slug: "working-with-soap-and-xml-apis"
updated: 2023-10-31T16:20:51Z
published: 2023-10-31T16:20:52Z
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.
# Trabalho com APIs SOAP e XML
## Visão geral
*Um guia com dicas e truques para trabalhar com APIs baseadas em XML*
[Os Tulip Connectors](https://support.tulip.co/docs/an-overview-of-http-connectors) podem ser usados para interagir com muitos tipos de fontes de dados externas. Este artigo se concentra em APIs HTTP que trocam informações usando [XML](https://en.wikipedia.org/wiki/XML). Essa categoria inclui APIs [SOAP](https://en.wikipedia.org/wiki/SOAP).
## Envio de dados XML no Tulip
Para enviar conteúdo XML no corpo de uma solicitação, use a notação `$value$` para mostrar que um parâmetro deve ser inserido.
Por exemplo, com o seguinte no campo 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$
>
>
>
>
>
>
>
>
> ```
>
>
>
e os valores `input1` e `input2` como entradas para a Connector Function, uma solicitação é feita com os valores de `input1` e `input2` substituídos no Request Body.
Isso é mostrado na interface da Tulip Connector Function abaixo:
{height="" width=""}
## Analisando dados XML no Tulip
### Um exemplo simples de API
Vamos começar com um exemplo simples de resposta de uma API XML.
```
xml version="1.0" encoding="UTF-8"?
Italiano do cotidiano
Giada De Laurentiis
2005
30.00
Harry Potter
J. K. Rowling
2005
29.99
Aprendendo XML
Erik T. Ray
2003
39.95
```
Os exemplos a seguir mostram como acessar as várias informações no Tulip.
Um extrator de:
`/bookstore/book[1]/title`
retorna:
`
Everyday Italian`
Observe que as matrizes em XML são "1-indexadas", o que significa que o primeiro elemento está na posição "1", ao contrário da {{glossary.JSON}}-query, que é "0-indexada".
Um extrator de:
`/bookstore/book[1]/title/text()`
retorna:
`Everyday Italian`
Observe que a função `/text()` é usada para extrair o valor do texto contido no nó selecionado.
Um extrator de:
`/bookstore/book[@category="children"][1]/title/text()`
retorna:
`Harry Potter`
Observe que o seletor nos permitiu pesquisar nas propriedades de um nó.
Esses exemplos podem ser usados diretamente no Tulip, conforme mostrado abaixo:

### Um exemplo de API SOAP
Agora vamos examinar um caso mais complexo com namespaces, um recurso típico das APIs SOAP.
```
>
>
>
>
>
>
>
>
> 0
>
>
>
>
>
> informações recuperadas com sucesso
>
>
>
>
>
>
>
> Minha operação
>
> Nenhuma
>
> 1234567-890
>
> B
>
>
>
>
>
>
>
> Número da peça
>
> 1234567-890
>
>
>
>
>
> Revisão da peça
>
> B
>
>
>
>
>
> Descrição da peça
>
> Minha peça de exemplo
>
>
>
>
>
>
>
> Normal
>
>
>
>
>
>
>
>
>
>
>
>
> ```
>
>
>
Essa resposta usa Namespaces XML, o que aumenta a complexidade. Na maioria dos casos, uma pesquisa global usando os operadores `//*` e `.//*` torna a extração muito simples.
Um extrator de:
`//*[local-name()="propertyName"][1]/text()`
retorna:
`PartNumber`
Observe que as matrizes em XML são "indexadas em 1", o que significa que o primeiro elemento está na posição "1", ao contrário da consulta json, que é "indexada em 0".
Um extrator de:
`//*[local-name()="Property"]`
retorna:
` PartNumber 1234567-890 PartRevision B PartDescription Minha parte de exemplo `
Observe aqui que os namespaces são "trazidos" para esse resultado. Portanto, uma subconsulta ainda pesquisaria o namespace global.
Para extrair uma matriz de objetos, use a pesquisa global mostrada no exemplo anterior para extrair a matriz e, em seguida, um extrator de pesquisa local de:
`.//*[local-name()="propertyName"]/text()`
para recuperar uma matriz de objetos do tipo:
`[ { "Name": "PartNumber"
"Value": "1234567-890" }, { "Name": "PartRevision"
"Value" (Valor): "B"
}, { "Name": "PartDescription"
"Value" (Valor): "My example part"
}
]`
Esses exemplos são mostrados na interface de conectores da Tulip abaixo:

---
Encontrou o que estava procurando?
Você também pode acessar [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!
```