...
With external requests, you can call APIs from other third parties or your own server to request data, submit data and etc.
...
In an Action step, find "External Request" in "Advance Actions" and click "Add your request" then start editing it:
...
...
| Table of Contents |
|---|
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:
...
escolha um tipo de solicitação como GET, POST, etc.
paste your request cole o URL/endpoint adjust "URL parametersda sua solicitação
ajuste a seção "Parâmetros de URL", "HeadersCabeçalhos", "BodyCorpo" or ou "Authorization" section if needed. e.g. setup API key
click "Test" and area 5 will show in the "Response" section with a response code
click on "Response Headers" to expand the header for more details and the received data is in blue
choose which part of the data you need by clicking the circle on the left-side accordingly
after clicking area 6, the JSON path for the selected data is automatically shown here. $ means the whole JSON.
choose which custom field to store the data. You can create a new field here by typing in a field name and clicking it in the drop-down. Click the "Add" button to add to the mapping list
finally, the mapping shows in area 9. Add as many mapping as needed and click "SaveAutorização", se necessário. por exemplo, configurar chave de API
clique em "Teste" e a área 5 será exibida na seção "Resposta" com um código de resposta
clique em "Cabeçalhos de resposta" para expandir o cabeçalho para mais detalhes e os dados recebidos ficam em azul
escolha qual parte dos dados você precisa clicando no círculo no lado esquerdo de acordo
após clicar na área 6, o caminho JSON para os dados selecionados é mostrado automaticamente aqui. $ significa todo o JSON.
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
por fim, o mapeamento é exibido na área 9. Adicione quantos mapeamentos forem necessários e clique em "Salvar".
| Note |
|---|
Testing Value - Make sure you provide testing data for any one of the fields/variables in the settings before you use the Test buttonValor de teste - 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
...
...
In the above screenshot, we can see that there is a URL parameter in the endpoint called "user_name". Remember to copy the endpoint down and provide a testing value.
Alternatively, you can use the URL Params sections for the same result.
Headers
...
Same as URL Params, put your key name first, then insert the variable and provide a testing value.
Authorization
...
Alternatively, put the token in the Authorization section. It's going to be less error-prone (sometimes people just forgot the "Bear " in front of the token).
Moreover, for Basic Auth, simply put your username and password value and the system will do the base64 encoding for you.
Body
To include a file itself in the parametersNa captura de tela acima, podemos ver que existe um parâmetro de URL no endpoint chamado “user_name”. Lembre-se de copiar o endpoint e fornecer um valor de teste.
Alternativamente, você pode usar as seções URL Params para o mesmo resultado.
Cabeçalhos
...
Assim como URL Params , coloque o nome da chave primeiro, depois insira a variável e forneça um valor de teste.
Autorização
...
Alternativamente, coloque o token na seção Autorização . Será menos sujeito a erros (às vezes as pessoas simplesmente esquecem o “Urso” na frente do token).
Além disso, para Basic Auth , basta colocar o valor do 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 works just like URL Params or Headers section.Instead of listing all the payloads in funciona exatamente como parâmetros de URL ou seção de cabeçalhos .
Em vez de listar todas as cargas em x-www-form-urlencoded , you can also paste the example payload in raw JSON:
...
On the left-hand side, Body Content, paste or write your JSON first, when you insert a variable, the Test body content shows on the right side immediately. It's to specify a testing JSON value.
Click on Copy from body content to copy the whole JSON structure. All the variables will be replaced by você também pode colar a carga de exemplo em JSON bruto:
...
No lado esquerdo, Body Content , cole ou escreva seu JSON primeiro, quando você insere uma variável, o conteúdo do corpo do teste é exibido imediatamente no lado direito. É 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}}. Remove the placeholder and put your testing valuesRemova o espaço reservado e coloque seus valores de teste.
Testing
Once you are ready, click on the Test button next to the URL endpoint or in the Response section.
...
...
Teste
Quando estiver pronto, clique no botão Testar próximo ao endpoint da URL ou na seção Resposta .
...
Além das dicas sobre como mapear dados acima, você também pode 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á.