Roboteka
Roboteka · Robôs · Requisição HTTP GET/POST

Requisição HTTP GET/POST

O robô «Requisição HTTP GET/POST» envia uma requisição a uma API externa a partir de um processo de negócios. Aceita uma URL, o método (GET, POST, PUT, PATCH, DELETE, HEAD), o corpo da requisição, cabeçalhos em JSON e o tempo limite, e retorna o corpo da resposta, o código de status HTTP e um indicador de sucesso (Y/N). Funciona em processos de negócios e robôs do Bitrix24 (Alaio).

O robô executa uma requisição HTTP a uma API externa diretamente de um processo de negócios do Bitrix24 (Alaio) — sem código e sem serviços intermediários. Suporta os métodos GET, POST, PUT, PATCH, DELETE e HEAD, corpo de requisição arbitrário, cabeçalhos em JSON (ex.: Authorization) e tempo limite de 1 a 60 segundos. Casos típicos: enviar os dados do negócio a um sistema contábil externo ou consultar o status de um pedido na API de um serviço de entrega. Os redirecionamentos (até 5) são validados a cada salto, requisições a endereços de rede internos são bloqueadas e o corpo da resposta é limitado a 1 MB. Retorna o corpo da resposta, o código de status HTTP e o indicador de sucesso (Y/N): analise a resposta com o robô «Extrair valor de JSON por caminho» e crie uma condição com o indicador no designer de processos. Não é executado enquanto o Bitrix24 estiver no modo de demonstração.

Quais parâmetros de entrada o robô aceita?

Parâmetro Tipo Obrigatório? Padrão
URL string sim
Método HTTP (padrão GET) select GET, POST, PUT, PATCH, DELETE, HEAD — GET
Corpo da requisição (para POST/PUT) string —
Cabeçalhos em JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} string —
Tempo limite em segundos (padrão 10) int —

O que o robô retorna?

Parâmetro Tipo
Corpo da resposta string
Código de status HTTP int
Sucesso (Y/N) — código 2xx string

Quais erros o robô pode retornar?

O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.

  • Erro: o método deve ser um de {methods}
  • Erro: os cabeçalhos devem ser um objeto JSON
  • Erro: nome de cabeçalho inválido: {name}
  • Erro: caracteres de controle não são permitidos no cabeçalho {name}
  • Erro: o cabeçalho {name} é definido automaticamente
  • Erro de cURL: {error}
  • Este robô não é executado enquanto o Bitrix24 estiver no modo de demonstração ou se não for possível identificar o plano.

Cenário: consultar o status de um pedido em um serviço externo

  1. Um negócio passa para a etapa «Entrega» e aciona o robô
  2. O robô envia uma requisição GET à API do serviço de entrega com o número do pedido
  3. O robô «Extrair valor de JSON» obtém o status da resposta
  4. O status é gravado em um campo do negócio e fica visível ao gerente

Robôs semelhantes

Artigos relacionados