Artigos sobre: Integrador de Apps

Guia de Resposta

Ao contrário da guia de requisição, no campo direito, em vez de uma entrada, um select é exibido, na qual é selecionado um campo de entidade específico.



Content-type



É indicado o formato da resposta da solicitação na qual ela vai ser recebida. As seguintes opções estão disponíveis:

JSON

XML

urlEncoded


Em Response, o formato da requisição é especificado separadamente, pois há casos em que a solicitação vai para urlEncoded e a resposta vem em JSON.

A resposta será aceita estritamente no formato selecionado no widget; se a resposta vier em um formato diferente, o parsing (segregação de campos) da resposta não funcionará.

O caminho para a matriz de dados



Este campo é usado se a resposta vier em uma matriz de objetos e pode haver um número ilimitado deles (por exemplo, gatilhos de API que fazem uma solicitação para obter uma lista de entidades).

Veja um exemplo para o seguinte formato de dados da resposta:

{"data":[ { "name":"Albato", "phone":"+79681112233" } { "name":"Albato2", "phone":"+79681112244" }]}


Se você precisar obter os dois objetos, a caixa de seleção "Return data array" deverá ser marcada. O campo indica o mapeamento para o conjunto desejado, que neste caso é data. Além disso, nos campos criados, o mapeamento pode ser especificado sem um caminho para este massivo.

Também é possível marcar a caixa, mas deixar o campo vazio. Isso significa que os dados vêm na raiz do massivo, por exemplo:

[ { "name":"Albato", "phone":"+79681112233" } { "name":"Albato2", "phone":"+79681112244" }]


Um gatilho com essa configuração, depois de receber essa resposta, será lançado exatamente tantas vezes quanto houver objetos na resposta.

Cabeçalhos



Se precisar obter o valor dos cabeçalhos, os campos serão adicionados nesta guia. Em cada campo, a chave é indicada à esquerda e o campo da entidade é selecionado à direita, onde é preciso salvar o valor resultante. Por exemplo, quando você precisa obter o valor do cabeçalho:

-H "dateTimeEvent: 2021-08-09 19:00:00"


No campo esquerdo é especificada a chave dateTimeEvent, e no campo direito seleciona-se o campo onde precisa salvar o valor:



Parâmetros



Os campos que precisam ser obtidos do próprio corpo da solicitação são adicionados na aba de parâmetros.

No campo esquerdo, está escrito o mapeamento para a chave da variável, cujo valor deve ser obtido (a regra de mapeamento é semelhante ao mapeamento na guia Request). No campo à direita, é selecionado o campo da entidade, no qual será salvo o valor recebido.

Além disso, os campos têm uma caixa de seleção adicional em Conjunto Tipo Array. Esta caixa de seleção indica que a variável está no massivo especificado no campo Caminho para o conjunto de dados e o mapeamento deve ser especificado sem um caminho para este massivo.

Veja um exemplo para a seguinte resposta:

{"id": 12345,"data":[ { "name":"Albato1", "phone":"+79681112233" } { "name":"Albato2", "phone":"+79681112244" }]}


Nesse caso, especificando o caminho para o massivo, é possível criar três campos. O campo que captura o valor de ID não precisa ser marcado, mas os demais sim:



Assim, os dados serão recebidos duas vezes. A cada vez, o nome e o número do telefone serão únicos, e em ambos os casos será atribuído um ID a partir da raiz da resposta.

Se o campo selecionado, onde o valor está armazenado, for do tipo DateTime ou Phone, terá uma engrenagem com configurações adicionais, semelhantes aos tipos de variáveis ​​da guia Request. Estes campos são opcionais e, caso não os preencha, o telefone virá no formato que o sistema o enviou, e a data tentará ser convertida automaticamente para o formato Y-m-d H:i:s, mesmo que chegue unixtime. Se o formato da data não for padrão, você deve registrar o seu formato.

Atualizado em: 01/12/2022

Este artigo foi útil?

Compartilhe seu feedback

Cancelar

Obrigado!