Τεκμηρίωση · Ειδοποιήσεις

Webhooks

Το JSON που στέλνουμε με POST, η κεφαλίδα υπογραφής για να το επαληθεύσετε, και πώς λειτουργούν οι επαναλήψεις.

Ένα κανάλι webhook λαμβάνει ένα POST ανά συμβάν με σώμα JSON. Προσθέστε το στο Alerts → Channels → Add channel → Webhook με ένα URL https που δεν περιέχει διαπιστευτήρια· ιδιωτικές και δεσμευμένες διευθύνσεις απορρίπτονται. Τα webhooks που προστέθηκαν με σκέτο http πριν από τις 31 Οκτωβρίου 2026 συνεχίζουν να λειτουργούν και σημειώνονται ως «http · needs https when changed» στη λίστα Alerts· την επόμενη φορά που θα επεξεργαστεί κάποιο, πρέπει να είναι https.

Κεφαλίδες

Content-Type: application/json
X-PingWise-Event: monitor.down
X-PingWise-Timestamp: 1761912000
X-PingWise-Signature: sha256=<hex>

Η υπογραφή είναι HMAC-SHA256(secret, "<timestamp>.<raw body>"), με το μυστικό υπογραφής που εμφανίζεται στη σελίδα του καναλιού. Επαληθεύστε την από την πλευρά σας και απορρίψτε αιτήματα των οποίων το timestamp είναι παλαιότερο από λίγα λεπτά. Οι ίδιες τρεις κεφαλίδες στέλνονται επίσης με τα παλαιότερα ονόματα X-UptimeBox-*.

Σώμα

{
  "event": "monitor.down",
  "monitor": {"id": "…", "name": "Shop", "type": "http", "target": "https://shop.example.com/"},
  "state": "down",
  "previous_state": "up",
  "reason": "timeout",
  "detail": "No response within 10 s",
  "at": "2026-10-31T12:00:00Z",
  "incident": {"id": 42, "started_at": "…", "confirmed_at": "…", "resolved_at": null, "duration_seconds": null},
  "explanation": null,
  "checks": [{"status": "down", "reason": "timeout", "ms": null, "code": null, "continent": "EU"}],
  "notes": "Hosted on web-03. Contact: Nikos."
}

Συμβάντα: monitor.down, monitor.up, monitor.blocked, monitor.unblocked, monitor.partial, monitor.reachable, monitor.slow, monitor.normal· group.<kind> για μια ομαδοποιημένη ειδοποίηση, με group, count και monitors[]· domain.expiring και domain.expired· και test από το κουμπί Send test. Το explanation συμπληρώνεται σε λογαριασμούς με εξηγήσεις AI.

Παράδοση

Timeout δέκα δευτερολέπτων, οι ανακατευθύνσεις δεν ακολουθούνται. Για μια αποτυχημένη παράδοση γίνονται έως έξι προσπάθειες συνολικά: ξανά μετά από 30 δευτερόλεπτα, 2 λεπτά, 10 λεπτά, 30 λεπτά και μία ώρα. Ένα 400, 401, 403, 404 ή 410 θεωρείται οριστικό και δεν επαναλαμβάνεται· ένα 429 με Retry-After γίνεται σεβαστό, έως μία ώρα. Η σελίδα του καναλιού δείχνει τις τελευταίες 20 παραδόσεις και τις απαντήσεις τους.

Τελευταία αλλαγή: 31 Οκτωβρίου 2026.