Pinging API

Each monitor has a secret URL. Your job requests that URL when it runs. GET or POST both work.

Success

Signal that the job finished successfully. Resets the next-due window.

GET|POST https://diditcron.com/p/<token>
curl -fsS "https://diditcron.com/p/<token>"

Start

Optional. Call when the job begins. Useful for long runs so you can see that work started before the success ping.

GET|POST https://diditcron.com/p/<token>/start

Fail

Report an immediate failure. Marks the monitor down and sends alerts. You may include a short message in the request body (truncated).

GET|POST https://diditcron.com/p/<token>/fail
curl -fsS -X POST \
  -H "Content-Type: text/plain" \
  --data "pg_dump exited 1" \
  "https://diditcron.com/p/<token>/fail"

Responses

  • 200 — ping accepted
  • 404 — unknown or rotated token
  • 429 — rate limited