Ação Avançada - Solicitação Externa

Owned by Equipe de Suporte
jul. 19, 2024
3 min read

Com solicitações externas, você pode chamar APIs de terceiros ou do seu próprio servidor para solicitar dados, enviar dados e etc.

 

Em uma etapa de Ação, encontre "Solicitação externa" em "Ações avançadas" e clique em "Adicionar sua solicitação" e comece a editá-la:

 

  1. escolha um tipo de solicitação como GET, POST, etc.

  2. cole sua URL de solicitação / endpoint

  3. ajuste a seção "Parâmetros de URL", "Cabeçalhos", "Corpo" ou "Autorização" se necessário. por exemplo, configure a chave da API

  4. clique em "Testar" e a área 5 será exibida na seção "Resposta" com um código de resposta

  5. clique em "Cabeçalhos de resposta" para expandir o cabeçalho e obter mais detalhes e os dados recebidos estão em azul

  6. escolha qual parte dos dados você precisa clicando no círculo no lado esquerdo de acordo

  7. após clicar na área 6, o caminho JSON para os dados selecionados é mostrado automaticamente aqui. $ significa o JSON completo.

  8. escolha qual campo personalizado armazenar os dados. Você pode criar um novo campo aqui digitando um nome de campo e clicando nele no menu suspenso. Clique no botão "Adicionar" para adicionar à lista de mapeamento

  9. finalmente, o mapeamento é exibido na área 9. Adicione quantos mapeamentos forem necessários e clique em "Salvar".

 

Testando valor - Certifique-se de fornecer dados de teste para qualquer um dos campos/variáveis ​​nas configurações antes de usar o botão Testar .

 

Parâmetros de URL

 

Na captura de tela acima, podemos ver que há um parâmetro de URL no endpoint chamado "user_name". Lembre-se de copiar o endpoint para baixo e fornecer um valor de teste.

Como alternativa, você pode usar as seções URL Params para o mesmo resultado.

 

Cabeçalhos

 

Assim como nos parâmetros de URL , coloque o nome da sua chave primeiro, depois insira a variável e forneça um valor de teste.

 

Autorização

 

Alternativamente, coloque o token na seção Authorization . Vai ser menos propenso a erros (às vezes as pessoas simplesmente esquecem o "Bear " na frente do token).

Além disso, para a autenticação básica , basta inserir seu nome de usuário e senha e o sistema fará a codificação base64 para você.

 

Corpo

Para incluir um arquivo nos parâmetros, use multipart/form-data :

 

x-www-for-urlencoded funciona exatamente como a seção Parâmetros de URL ou Cabeçalhos .

Em vez de listar todas as cargas úteis em x-www-form-urlencoded , você também pode colar a carga útil de exemplo em JSON bruto:

 

No lado esquerdo, Body Content , cole ou escreva seu JSON primeiro, quando você insere uma variável, o Test body content aparece no lado direito imediatamente. É para especificar um valor JSON de teste.

Clique em Copiar do conteúdo do corpo para copiar toda a estrutura JSON. Todas as variáveis ​​serão substituídas por {{ variable_name}}. Remova o placeholder e coloque seus valores de teste.

 

Testando

Quando estiver pronto, clique no botão Testar ao lado do ponto de extremidade da URL ou na seção Resposta .

 

Além das dicas sobre como mapear dados acima, você também pode querer salvar os valores no cabeçalho de resposta para uso posterior. Basta expandir o cabeçalho, clicar em um valor no cabeçalho e o caminho JSON para ele será exibido automaticamente lá.