Documentação do Cathook

Início rápido

1. Copie a URL do seu endpoint no topo do painel do bin.
2. Envie qualquer método HTTP para essa URL.
3. Veja os eventos chegando ao vivo e compare payloads.
4. Ajuste a resposta simulada para testar erros, delays e retries.

Enviar requisições

Teste qualquer método HTTP no seu endpoint (inclui webhooks por POST, mas também GET, PUT, PATCH e DELETE).

# POST (webhook comum)
curl -i -X POST "https://cathook.tech/in/{bin_id}" \
  -H "Content-Type: application/json" \
  -d '{"event":"checkout.completed","amount":12990,"currency":"BRL"}'

# GET (querystring)
curl -i "https://cathook.tech/in/{bin_id}?ping=1"

# PUT (JSON)
curl -i -X PUT "https://cathook.tech/in/{bin_id}" \
  -H "Content-Type: application/json" \
  -d '{"profile":"update","ok":true}'

# PATCH (parcial)
curl -i -X PATCH "https://cathook.tech/in/{bin_id}" \
  -H "Content-Type: application/json" \
  -d '{"plan":"pro"}'

# DELETE (com header de debug)
curl -i -X DELETE "https://cathook.tech/in/{bin_id}" \
  -H "X-Debug: true"

# HTTPie (POST)
http POST https://cathook.tech/in/{bin_id} event=ping ok:=true

# PUT
http PUT https://cathook.tech/in/{bin_id} plan=pro

# DELETE
http DELETE https://cathook.tech/in/{bin_id} X-Debug:true

# PowerShell (Invoke-RestMethod)
Invoke-RestMethod -Uri "https://cathook.tech/in/{bin_id}" `
  -Method POST `
  -Headers @{ "Content-Type" = "application/json" } `
  -Body '{"hello":"request","bin":"{bin_id}"}'

# Outros métodos
# Invoke-RestMethod -Uri "https://cathook.tech/in/{bin_id}" -Method PUT -Body '{"plan":"pro"}'
# Invoke-RestMethod -Uri "https://cathook.tech/in/{bin_id}" -Method DELETE

# Python (requests)
import requests

# POST
r = requests.post("https://cathook.tech/in/{bin_id}", json={"ok": True, "source": "python"})
print(r.status_code, r.text)

# DELETE
# r = requests.delete("https://cathook.tech/in/{bin_id}", headers={"X-Debug": "true"})

// Node.js (fetch)
const res = await fetch("https://cathook.tech/in/{bin_id}", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ ok: true, source: "node" })
});
console.log(res.status, await res.text());

// DELETE
// const del = await fetch("https://cathook.tech/in/{bin_id}", { method: "DELETE" });

Resposta simulada

Defina status, cabeçalhos e corpo retornados ao remetente para testar comportamentos de retry, backoff e tratamento de erros.

• Sem Content-Type, o Cathook usa application/json quando o corpo começa com {; senão, text/plain.
• Use delay (ms ou s) para simular lentidão de serviços e validar timeouts do emissor (ex.: 3000 = 3s).
• Teste respostas 2xx/4xx/5xx e observe como seu provedor reenvia eventos.

Replay de eventos

Reenvie um evento capturado para outra URL. Você pode sobrepor cabeçalhos (por exemplo, tokens de teste) durante o replay.

Exportar e limpar

Use Exportar para baixar os eventos do bin e Apagar tudo para limpar o histórico (irreversível).

Limites e privacidade

• Retenção padrão: 24 horas (MVP)
• Tamanho máximo do corpo por evento: configurável por instância
• Acesso ao bin é privado por cookie de visualização. Compartilhe com cautela.

Perguntas rápidas