Internal HTTP/JSON relay and event ingestion gateway. Accepts signed webhook payloads, worker heartbeats and telemetry batches from registered clients. Public registration is disabled.
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /v1/health |
None | Liveness probe and build timestamp |
| POST | /v1/events/ingest |
Bearer | Batch JSON event ingestion (max 512 KB) |
| POST | /v1/hooks/dispatch |
HMAC-SHA256 | Signed outbound webhook queue |
| GET | /v1/metrics/summary |
Bearer | Aggregated 5m counters for monitoring agents |
| HEAD | /v1/jobs/heartbeat |
Bearer | Worker lease renewal |
Requests to protected endpoints must include an Authorization header with a provisioned service token. Unauthenticated requests return 401 Unauthorized.
curl -sS https://servapi.duckdns.org/v1/metrics/summary \ -H "Authorization: Bearer <service_token>" \ -H "Accept: application/json"