watch

Create Ping Watch

Buy an HTTP ping watch: one URL, five regions on four continents, up to 24 hours.

Same gate order as the propagation create, with one gate more: the URL is put through the SSRF seam (structural rules, then resolve-and-pin) BEFORE the lane opens, so a target we would never dispatch five hosts at is a free 422. The per-check re-resolve in watch/ping.py is what closes the rebinding window afterwards — this pre-flight only keeps an unbuyable target from being sold.

post/watch/ping

Request

  • Base URL: https://dnsdoctor.dev/api/v1
  • URL: https://dnsdoctor.dev/api/v1/watch/ping
  • Auth: none declared

Request body

urlstring required

The URL to check. It is fetched over the shared probe fleet and stored for the life of the watch, so it must not carry a secret — no token, key or signature in the path or query.

cadence_secondsinteger
window_hoursnumber

Response

Successful Response

watch_idstring required
kindstring required
targetstring required
record_typestring nullable required
expected_valuestring nullable required
statestring required
cadence_secondsinteger required
window_hoursnumber required
price_usdstring required
created_atstring required
expires_atstring required
results_expire_atstring required
poll_urlstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.