Conecta-seEntrar na plataforma

Requisição HTTP

Chamar qualquer API HTTP e aproveitar a resposta dentro do fluxo.

Lógica e processamentoAPIs e operações técnicasConexão: Sem conexão externa obrigatória

O que faz

Conecte-se a qualquer API externa, com suporte a todos os métodos HTTP padrão e parâmetros de requisição personalizáveis. Configure cabeçalhos, parâmetros de consulta e o corpo da requisição. Os cabeçalhos padrão (User-Agent, Accept, Cache-Control etc.) são incluídos automaticamente.

Quando usar: Use quando o seu fluxo precisar chamar qualquer API HTTP e aproveitar a resposta dentro do fluxo.

Exemplo de situação: Automatizar uma operação técnica sem executar o trabalho manualmente.

Antes de começar

Conexão necessária: Sem conexão externa obrigatória.

Nenhuma conta externa é obrigatória para usar este bloco.

Passo a passo

  1. Adicione Requisição HTTP ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Nenhuma conta externa é obrigatória para usar este bloco.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • URL da API

    Obrigatório

    Informa o endereço HTTPS do serviço ou recurso que será acessado.

    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Método HTTP

    Obrigatório

    Escolhe o método HTTP da requisição, como GET, POST, PUT ou DELETE.

    Opções:
    GET · POST · PUT · DELETE · PATCH · HEAD · OPTIONS
    Padrão:
    GET

  • Parâmetros da URL

    Pares nome/valor acrescentados ao fim da URL como parâmetros de consulta, depois do “?” (ex.: nome cep e valor 01310-100 viram ?cep=01310-100).

  • Cabeçalhos

    Cabeçalhos em pares nome/valor. Para credenciais, use referências ao cofre do workspace.

  • Corpo da requisição

    Informa o conteúdo enviado no corpo da requisição.

    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Tempo limite (ms)

    Em campos adicionais

    Limite total de 1.000 a 120.000 ms, incluindo tentativas, redirecionamentos e leitura da resposta. Padrão: 30.000 ms.

    Padrão:
    30000

  • Tentativas adicionais

    Em campos adicionais

    Até 5 novas tentativas em 408, 429 ou falhas temporárias. Padrão: nenhuma. POST/PATCH exigem habilitação explícita.

    Padrão:
    0

  • Espera inicial entre tentativas (ms)

    Em campos adicionais

    Espera inicial com aumento exponencial, respeitando o tempo limite da chamada.

    Exemplo:
    500

  • Espera máxima entre tentativas (ms)

    Em campos adicionais

    Espera máxima, limitada a 30.000 ms e ao tempo restante da chamada.

    Exemplo:
    10

  • Repetir POST e PATCH

    Em campos adicionais

    Pode repetir ações que criam cobranças ou registros. Ative apenas se a API de destino deduplicar a chave de idempotência.

    Exemplo:
    false

  • Parâmetros do caminho

    Substitui :id ou {id} na URL com valores codificados.

    Exemplo:
    /documentos/exemplo.pdf

  • Formulário multipart

    Objeto nome/valor para enviar formulário em vez de JSON. Não combine com corpo.

    Exemplo:
    { "chave": "valor" }

  • Seguir redirecionamentos

    Em campos adicionais

    Segue apenas destinos HTTP públicos. Credenciais não são enviadas a outra origem.

    Padrão:
    true

  • Máximo de redirecionamentos

    Em campos adicionais

    Define um valor numérico, quantidade ou limite da operação.

    Padrão:
    5
    Exemplo:
    10

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <requisicaohttp.status>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<requisicaohttp.status>numberCódigo HTTP retornado pela API.
<requisicaohttp.data>jsonConteúdo da resposta. Use data.nomeDoCampo nas próximas etapas.
<requisicaohttp.body>jsonConteúdo da resposta, equivalente a data.
<requisicaohttp.headers>jsonCabeçalhos da resposta sem credenciais sensíveis.

Exemplo de uso

Objetivo: Automatizar uma operação técnica sem executar o trabalho manualmente.

InícioRequisição HTTPpróxima etapa
URL da API
https://api.exemplo.com/v1/recurso
Método HTTP
GET
Corpo da requisição
Olá! Sua solicitação foi processada com sucesso.
Parâmetros do caminho
/documentos/exemplo.pdf

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <requisicaohttp.status>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Blocos relacionados