POST /ping

Request

POST /ping
Authorization: Bearer <api_key>
Content-Type: application/json

Pola body

Pole	Typ	Wymagane	Opis
event_type	string	tak	ping, stream_event lub własny
monitor	string	tak	Nazwa monitora (slug, max 255 znaków)
status	string	tak*	Status zdarzenia — zobacz Typy zdarzeń i statusy
duration	float	nie	Czas wykonania w sekundach
exit_code	int	nie	Exit code procesu
host	string	nie	Hostname maszyny, na której leciał job
message	string	nie	Dowolna wiadomość / wycinek logu
timestamp	int	nie	Unix timestamp (domyślnie now)

*Dla event_type: "ping" nazwa pola to status. Dozwolone wartości: run, complete, fail, skip.

Przykład — lifecycle zadania

// Job started
{
  "event_type": "ping",
  "monitor":    "db-backup",
  "status":     "run",
  "host":       "server-01"
}

// Job finished successfully
{
  "event_type": "ping",
  "monitor":    "db-backup",
  "status":     "complete",
  "duration":   47.3,
  "exit_code":  0
}

Przykład — skip (maintenance window)

{
  "event_type": "ping",
  "monitor":    "payment-service",
  "status":     "skip"
}

Dla szybkich jednolinijkowych komend shell bez body JSON, użyj GET /ping — przyjmuje te same wartości status i wspiera autentykację ?api_key= w URL.

Response

200 OK

{ "status": "success" }

400 Bad Request

{ "error": "required field missing: status" }

401 Unauthorized

{ "error": "unauthorized" }