Enviar solicitação HTTP

A açãoEnviar solicitação HTTPconecta o fluxo de trabalho a um servidor web ou URL e envia solicitações HTTP.

Depois de enviar uma solicitação HTTP, o Flow espera no máximo 30 segundos por umcódigo de resposta HTTP. Caso não receba uma resposta após esse período, ele fecha a conexão com o app e envia a solicitação novamente.

Campos

A açãoSend HTTP request("Enviar solicitação HTTP") apresenta os campos a seguir.

Campos usados na ação Send HTTP request ("Enviar solicitação HTTP").
Campo Descrição
Método HTTP O método de solicitação HTTP para enviar. Lembre-se de que a açãoSend HTTP request(“Enviar solicitacao HTTP”)e compativel com os seguintes métodos:

  • Get: envia uma solicitação de informação do servidor.
  • 删除: remove um recurso do servidor.
  • Head: recupera os cabeçalhos de resposta HTTP do servidor.
  • Options: recupera opcoes e recurso项目aceitos pelo就是dor.
  • Patch: atualiza parcialmente um recurso no servidor.
  • Put: atualiza um recurso no servidor.
  • Post: cria um recurso ou substitui um recurso no servidor.
URL O URL do servidor para o qual a solicitação HTTP é enviada.
Cabeçalhos O par de chave-valor da solicitação HTTP. É possível inserir vários deles.
Corpo O conteúdo a ser enviado para o servidor.

Acionadores

É possível usar a açãoSend HTTP request("Enviar solicitação HTTP") nos fluxos de trabalho.

Exemplos

Chamar a API Admin GraphQL da Shopify

Neste exemplo, você chamará a APIproductUpdatepara usar o Flow na edição de um título de produto.

Antes de começar, faça o seguinte:

Em seguida, siga estas etapas no Flow:

  1. Escolha o acionadorProduct status updated("Status do produto atualizado"), que permite alterar o status de um item para testar o fluxo de trabalho.
  2. AdicioneSend HTTP Request("Enviar solicitação HTTP") ao fluxo de trabalho e conecte-a ao acionador.
  3. Clique na etapaSend HTTP Request("Enviar solicitação HTTP") para abrir o painel de configuração.
  4. No campoHTTP Method("Método HTTP"), insiraPOST.
  5. No campoURL, insirahttps://YOUR-SHOP-DOMAIN.myshopify.com/admin/api/2023-01/graphql.jsonpara substituir o domínio da loja e a versão da API desejada.
  6. Na seçãoHeaders("Cabeçalhos"), insiraX-Shopify-Access-TokencomoKey("Chave") eYOUR_API_SECRET_KEYcomoValue("Valor"), que foram obtidos na primeira etapa.
  7. Na seçãoHeaders("Cabeçalhos"), insira um segundo cabeçalho headerContent-TypecomoKey("Chave") eapplication/jsoncomoValue("Valor").
  8. Na seçãoBody("Corpo"), insira:

json {"query": "mutation { productUpdate(input: {id: \"{{ product.id }}\", title: \"{{product.title}}-edited\"}) { product { id } } }"}

  • Esse código adiciona-editedao final do título.
  • Espaços e linhas novas são significativos para o editor do Liquid, portanto evite adicionar ou remover espaços. Além disso, exceto para a saída do Liquid, evite colchetes recolhidos, como{{e}}, pois são reservados para variáveis do Liquid.
  1. Configure o restante do fluxo de trabalho e ative-o.
  2. Para testá-lo, altere o status de um produto deRascunhoparaAtivoou vice-versa.

Chamar uma API externa

Exemplo de um fluxo de trabalho que envia uma solicitação HTTP POST quando um pedido é pago

No fluxo de trabalho acima, uma solicitação HTTP POST é enviada a um servidor quando um pedido é pago.

Códigos de resposta

Veja na tabela a seguir uma descrição de como o Flow processa ocódigo de resposta HTTPdepois que recebe uma resposta.

Como o Flow processa códigos de resposta HTTP.
Código de resposta HTTP Como o Flow processa o código de resposta
Sucesso 2XX ou 3XX O Flow marca a solicitação HTTP como bem-sucedida e realiza as próximas ações do fluxo de trabalho.
Erro 429 ou 5XX O Flow repete a ação automaticamente por no máximo 24 horas até receber um código de resposta diferente ou atingir o tempo-limite.
Outro código de resposta Se o app retorna um código não descrito nesta tabela ou atinge o tempo-limite enquanto repete as ações, o Flow marca a solicitação HTTP como malsucedida. Além disso, as próximas ações do fluxo de trabalho não são realizadas.

Tudo pronto para começar a vender com a Shopify?

Experimente de graça