Cathook Documentation

Quick start

1. Copy your endpoint URL from the top of the bin dashboard.
2. Send any HTTP method to this URL.
3. See events arriving live and compare payloads.
4. Adjust the simulated response to test errors, delays, and retries.

Send requests

Test any HTTP method on your endpoint (includes webhooks via POST, but also GET, PUT, PATCH, and 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" });

Simulated response

Set the returned status, headers, and body sent back to the sender to test retry behavior, backoff, and error handling.

• Without a Content-Type, Cathook uses application/json when the body starts with {; otherwise, text/plain.
• Use delay (ms or s) to simulate service slowness and validate sender timeouts (e.g., 3000 = 3s).
• Test 2xx/4xx/5xx responses and see how your provider resends events.

Replay events

Resend a captured event to another URL. You can override headers (e.g., test tokens) during the replay.

Export and clear

Use Export to download the bin's events and Delete all to clear the history (irreversible).

Limits and privacy

• Default retention: 24 hours (MVP)
• Maximum body size per event: configurable per instance
• Access to the bin is private via view cookie. Share cautiously.

Quick questions