Endereços HTTP
Um endereço HTTP permite que outro sistema acione o agente.
Criar
| Campo | O que define |
|---|---|
| Identificador | O nome que aparece no endereço |
| Permanente | Só em production, e só com perfil de publicação |
| Validade | Em development, obrigatória |
| Limite por minuto | Padrão: 60 |
| Execuções simultâneas | Padrão: 5 |
| Tamanho máximo do corpo | Padrão: 256 KiB |
A credencial aparece uma única vez
Ao criar o endereço, a resposta traz a credencial — e é a única vez em que ela existe fora da plataforma. Guarde-a com segurança; depois disso, não há como recuperá-la, só gerar outra.
Como chamar
O chamador envia a credencial no cabeçalho de autorização e o corpo com os dados de entrada do agente.
A resposta é imediata e não é o resultado: ela confirma que a execução foi criada e diz onde acompanhá-la. O fluxo nunca roda dentro da requisição — uma automação que espera uma aprovação humana não caberia num tempo de resposta HTTP.
202 → execução criada, com identificador e endereço de acompanhamento
Detalhes de formato em API.
Os dados são validados
Diferentemente dos outros acionadores, o disparo por HTTP valida a entrada contra o que o agente declara: campos obrigatórios ausentes, tipo errado ou valor fora das opções são recusados na hora, sem criar execução.
O contrato para quem integra é, portanto, exatamente o que o agente declara.
Evitar disparo duplicado
O chamador pode enviar uma chave de idempotência. Repetir a mesma chave com o mesmo corpo devolve a execução original em vez de criar outra — o que torna seguro repetir a requisição depois de um tempo esgotado na rede.
Repetir a mesma chave com corpo diferente é recusado.
Limites
| Limite | O que faz |
|---|---|
| Por minuto | Teto de criação de execuções por endereço |
| Simultâneas | Teto de execuções em andamento por endereço |
| Tamanho do corpo | Teto de payload |
Estourar um deles devolve um erro específico, e não uma falha genérica. Trocar a chave de idempotência não contorna os limites.
Segurança
- A credencial é do endereço, não da sua sessão. Ela não dá acesso ao Studio nem a outros agentes.
- A organização é derivada do próprio endereço — quem chama nunca informa organização.
- Um identificador inexistente e uma credencial errada devolvem a mesma resposta, para que não seja possível descobrir identificadores válidos por tentativa.
- Apenas a impressão digital da credencial é guardada; o valor não.
Duração
| Ambiente | Comportamento |
|---|---|
development | Sempre temporário, com validade obrigatória |
production | Pode ser permanente, com perfil de publicação |
Erros comuns
| Resposta | Significado | O que fazer |
|---|---|---|
| Credencial inválida | Credencial errada, ou identificador inexistente | Confira os dois |
| Entrada recusada | Os dados não batem com o que o agente declara | Ajuste o corpo da chamada |
| Endereço expirado | O endereço temporário venceu ou foi revogado | Crie outro, ou torne-o permanente em produção |
| Corpo grande demais | Acima do limite | Reduza o payload |
| Limite atingido | Frequência ou simultaneidade | Espere e tente de novo |
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.