- Grátis
- Sem registo
- Expira em 24h
Testador de Webhook / Callback
Obtenha um URL temporário, aponte um callback para ele e inspecione os corpos recebidos e os cabeçalhos retidos. Concebido para depurar callbacks de tarefas assíncronas da HiAPI. Corpos POST com mais de 64 KiB devolvem 413 e nunca são armazenados nem truncados; cookies, cabeçalhos de IP reencaminhado/cliente e segredo de entrada não são retidos.
Quem tiver este URL pode ler o que chega aqui, e tudo é eliminado quando expira. Não o use para tráfego de produção ou dados sensíveis.
Publica um payload de exemplo no seu endereço a partir deste navegador, para que possa ver a ferramenta a funcionar antes de configurar um callback real.
Resposta que o remetente recebe
Altere isto para testar repetições: devolva um estado não-2xx e a HiAPI repetirá o callback, para que possa observar o calendário na lista.
Pedidos
À espera do primeiro pedido…
Aponte o seu callback para o URL acima ou envie um pedido de teste para ver como fica.
Detalhe do pedido
Selecione um pedido para ver os seus cabeçalhos e corpo.
Criar uma tarefa com este callback
Copie isto, substitua a chave e o modelo e execute.
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0",
"callback": { "url": "https://www.hiapi.ai/tools/webhook-tester/hook/YOUR_TOKEN", "when": "final" },
"input": { "prompt": "a cyan glass data center entrance", "duration": 5, "resolution": "720p" }
}'How to test a webhook in three steps
Copie o seu URL temporário
Abra esta página e copie o endereço que ela fornece. Permanece ativo durante 24 horas e aceita POST de qualquer origem.
Aponte o seu callback para ele
Passe-o como callback.url ao criar uma tarefa assíncrona, ou use o botão «Enviar pedido de teste» para disparar um imediatamente.
Leia o pedido
Os pedidos aparecem à medida que chegam. Inspecione cabeçalhos, corpo e tipo de conteúdo; cole a sua chave de assinatura de webhook para verificar a assinatura localmente.
What this tool cannot do
- Compara apenas a consistência HMAC da HiAPI, não a frescura ou a proteção contra repetição, e uma correspondência por si só não pode provar a origem. Sem uma chave de assinatura, um callback parece-se com qualquer outro POST.
- Corpos com mais de 64 KiB devolvem 413 e nunca são armazenados nem truncados. Cookies, cabeçalhos de IP reencaminhado/cliente e segredo de entrada não são retidos.
- A repetição não é um pedido original exato. Os cabeçalhos são removidos e as regras CORS, de conteúdo misto ou de rede local podem bloqueá-la; o acesso a localhost não é garantido.
- Não pode consultar tarefas. Apenas recebe payloads, pelo que não tem acesso ao estado da tarefa, saldo ou artefactos.
- Não é armazenamento permanente. O endereço e o seu conteúdo são destruídos após 24 horas, por isso não envie dados de produção ou sensíveis.
- O URL é uma credencial. Quem o tiver pode ler o que chega.
- Um destino localhost nunca recebe um callback real da HiAPI, porque a HiAPI tem de o alcançar através da internet pública.
Webhook tester FAQ
Para que serve um testador de webhooks?
Um testador de webhooks dá-lhe um endereço que aceita pedidos HTTP recebidos e mostra os cabeçalhos retidos e o corpo. Cookies, cabeçalhos de IP reencaminhado/cliente e segredo de entrada são descartados. Corpos com mais de 64 KiB devolvem 413 e nunca são armazenados nem truncados. Poupa-lhe o trabalho de montar um servidor apenas para inspecionar um callback.
Como testo um callback da HiAPI?
Crie uma tarefa na API da HiAPI e passe o URL desta página como callback.url. Quando a tarefa atinge um estado terminal, a HiAPI faz POST do resultado aqui e o pedido aparece na lista.
Porque é que o callback não chega quando testo localmente contra a HiAPI?
Um callback tem de ser acessível a partir da internet pública. A sua própria máquina normalmente não o é, por isso um endereço localhost nunca receberá um callback real da HiAPI. Use um URL num host público — esta página dá-lhe um.
Posso verificar se um callback veio mesmo da HiAPI?
Com uma chave de assinatura de webhook, esta ferramenta recalcula HMAC-SHA256 sobre o corpo retido e X-HiAPI-Timestamp e compara X-HiAPI-Signature localmente. Uma correspondência mostra consistência com essa chave, não frescura ou proteção contra repetição. Sem chave de assinatura, não há assinatura para comparar.
A minha chave de assinatura de webhook é enviada para o vosso servidor?
Não. A chave é usada apenas na API criptográfica do seu navegador para recalcular a assinatura. Nunca é transmitida, armazenada ou registada, e o pedido que chega ao nosso servidor não a contém.
Quanto tempo dura o endereço e o que acontece aos dados?
O endereço e tudo o que recebeu são eliminados após 24 horas. Cada endereço guarda até 50 pedidos. Trate o URL como uma credencial: quem o tiver pode ler o que chegou, por isso não o use para produção ou dados sensíveis.
Pode dizer-me com que frequência a HiAPI repete um callback falhado?
Sim, e é por isso que o estado da resposta é configurável. Defina a resposta como 400 ou 500, acione uma tarefa real e os tempos de chegada na lista mostram-lhe o calendário de repetições. As repetições ocorrem imediatamente, depois a +1, +5 e +20 minutos, quatro tentativas no total.
Posso repetir um pedido?
A repetição faz um pedido de melhor esforço a partir do seu navegador, não uma cópia exata. Cookies, autorização, cabeçalhos de proxy/plataforma e controlados pelo navegador não são reencaminhados, e os redirecionamentos são rejeitados. O destino deve permitir CORS; conteúdo misto HTTPS para HTTP e regras de rede local do navegador podem bloqueá-lo. Localhost pode funcionar mas não é garantido. Uma resposta bloqueada não prova que o destino não recebeu nada.