API για uptime monitoring
Ό,τι κάνεις στην εφαρμογή μπορείς να το κάνεις και μέσω του REST API: δημιούργησε monitors από το deployment pipeline σου, φέρε το uptime και τους χρόνους απόκρισης στα δικά σου dashboards, κράτα συγχρονισμένες τις σελίδες κατάστασης και τα κανάλια ειδοποιήσεων. JSON μέσα, JSON έξω, ένα token Bearer. Τα API tokens περιλαμβάνονται στο πακέτο Business και πάνω.
Πρώτα βήματα
Βασικό URL
https://app.centoculus.com/api/v1
Κάθε αίτημα φέρει δύο κεφαλίδες: Authorization: Bearer <token> και Accept: application/json. Τα αιτήματα με σώμα στέλνουν JSON με Content-Type: application/json.
- Δημιούργησε ένα token στο Ο λογαριασμός μου → API tokens στην εφαρμογή ιστού ή στο κινητό και διάλεξε τα scopes του.
- Αντίγραψε το token αμέσως· εμφανίζεται μόνο μία φορά.
- Κάλεσε το
GET /me. Λειτουργεί με κάθε token και σου λέει σε ποιον ανήκει το token.
Η πρώτη σου κλήση:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
Η απάντηση είναι ο χρήστης σου με ρόλο, γλώσσα και τα workspaces που φτάνει το token (συντομευμένη):
{
"data": {
"id": 4821,
"name": "Mara Lindqvist",
"email": "mara@example.com",
"role": "customer_admin",
"role_label": "admin",
"locale": "en",
"timezone": "Europe/Stockholm",
"customers": [{"id": 1207, "name": "Example Ltd"}],
"default_customer_id": 1207
}
}
Tokens και scopes
Ένα token έχει όνομα, προαιρετική λήξη (έως 730 ημέρες) και τα scopes που μπορεί να χρησιμοποιεί. Διάλεξε μόνο τα scopes που χρειάζεται μια ενσωμάτωση: ένα dashboard παίρνει monitors:read και incidents:read, ένα script deployment παίρνει monitors:write. Στα πακέτα κάτω από το Business η ενότητα είναι ορατή αλλά γκριζαρισμένη.
| Scope | Επιτρέπει |
|---|---|
monitors:read | Λίστα και προβολή monitors, uptime, ημερήσιο uptime, χρόνοι απόκρισης, τύποι ελέγχων, τοποθεσίες, σύνοψη dashboard |
monitors:write | Δημιουργία, ενημέρωση, διαγραφή, παύση και συνέχιση monitors |
servers:read | Λίστα και προβολή server και των μετρικών τους |
servers:write | Δημιουργία, ενημέρωση, διαγραφή, παύση και συνέχιση server· νέα εντολή εγκατάστασης για τον agent |
incidents:read | Λίστα και προβολή συμβάντων, σύνοψη dashboard |
status-pages:read | Λίστα και προβολή σελίδων κατάστασης |
status-pages:write | Δημιουργία, ενημέρωση και διαγραφή σελίδων κατάστασης και των ανακοινώσεών τους |
notifications:read | Λίστα και προβολή καναλιών ειδοποιήσεων και τύπων καναλιών |
notifications:write | Δημιουργία, ενημέρωση και διαγραφή καναλιών (e-mail, Telegram, webhook, push), αποστολή δοκιμής |
Το GET /me λειτουργεί με κάθε token. Η χρέωση, η ομάδα, τα tokens, η ασφάλεια του λογαριασμού και οι επισκευές δεν είναι προσβάσιμα με API token και απαντούν 403, όπως και μια κλήση χωρίς το κατάλληλο scope.
Ανάκαλεσε ένα token στο ίδιο σημείο· σταματά να λειτουργεί αμέσως.
Συμβάσεις
- Οι απαντήσεις είναι JSON. Ένα μεμονωμένο αντικείμενο έρχεται κάτω από το
data, μια λίστα κάτω από τοdataμαζί μεlinksκαιmeta. - Τα monitors και οι server προσδιορίζονται με UUID· τα συμβάντα, οι σελίδες κατάστασης και τα κανάλια ειδοποιήσεων με αριθμητικό id.
- Οι ώρες είναι ISO 8601 σε UTC, για παράδειγμα
2026-11-15T08:30:00.000000Z. - Οι λίστες σελιδοποιούνται με τις παραμέτρους
pageκαιper_page· τοmetaπεριέχειcurrent_page,last_page,per_pageκαιtotal. Προεπιλεγμένα μεγέθη σελίδας: monitors 15 (μέγ. 200), συμβάντα 25 (μέγ. 100), κανάλια ειδοποιήσεων 50, server 100, σελίδες κατάστασης 15. - Οι λογαριασμοί με πολλά workspaces (συνεργάτες και μεταπωλητές) περνούν
customer_idόταν δημιουργούν κάτι και μπορούν να φιλτράρουν τις λίστες με αυτό. Οι λογαριασμοί πελατών το παραλείπουν. - Δεν υπάρχει γενικό όριο αιτημάτων. Μερικά endpoints έχουν περιορισμό, για παράδειγμα η επαναποστολή επιβεβαίωσης e-mail (10 ανά λεπτό)· απαντούν 429 με
Retry-After. Μην κάνεις polling πιο συχνά από το διάστημα ελέγχου· για δεδομένα σε πραγματικό χρόνο χρησιμοποίησε κανάλι webhook.
Σφάλματα
Τα σφάλματα είναι JSON με ένα message. Τα σφάλματα επικύρωσης προσθέτουν errors με μία λίστα μηνυμάτων ανά πεδίο.
| Status | Σημασία |
|---|---|
401 | Token που λείπει, δεν είναι έγκυρο, έχει λήξει ή έχει ανακληθεί. |
402 | Η παρακολούθηση είναι σε παύση επειδή εξαντλήθηκε το προπληρωμένο υπόλοιπο (πελάτες μεταπωλητών)· συνεχίζεται μετά από ανανέωση. |
403 | Το token δεν έχει το scope, το endpoint είναι κλειστό για API tokens ή το πακέτο σου δεν περιλαμβάνει τη λειτουργία. |
404 | Δεν βρέθηκε ή δεν ανήκει στο workspace σου. |
409 | Σύγκρουση, για παράδειγμα επιβεβαίωση διεύθυνσης e-mail που έχει ήδη επιβεβαιωθεί. |
422 | Η επικύρωση απέτυχε· δες το errors. Όταν συναντηθεί όριο του πακέτου, το upgrade ονομάζει τη λειτουργία που ξεκλειδώνει ένα μεγαλύτερο πακέτο. |
429 | Πάρα πολλά αιτήματα σε endpoint με περιορισμό· περίμενε Retry-After δευτερόλεπτα. |
Ένα σφάλμα επικύρωσης:
HTTP/1.1 422 Unprocessable Content
{
"message": "The target field is required. (and 1 more error)",
"errors": {
"target": ["The target field is required."],
"interval_seconds": ["The interval must be at least 60 seconds on your plan."]
}
}
Monitors
Ένα monitor είναι ένας έλεγχος: μια ιστοσελίδα, ένα πιστοποιητικό SSL, ένα ping, μια θύρα TCP, μια εγγραφή DNS, ένα heartbeat cron ή οι ρυθμίσεις αλληλογραφίας ενός domain. Τύποι: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. Το GET /check-types σου λέει ποιους τύπους, διαστήματα και τοποθεσίες περιλαμβάνει το πακέτο σου και τις προεπιλογές κάθε τύπου.
| Endpoint | Τι κάνει |
|---|---|
GET /monitors |
Λίστα· φίλτρα status, search, ids (χωρισμένα με κόμμα), το with_stats=1 προσθέτει uptime και τελευταίο χρόνο απόκρισης |
POST /monitors |
Δημιουργία· οι έλεγχοι ξεκινούν στο παρασκήνιο |
GET /monitors/{id} |
Ένα monitor με τις τοποθεσίες και το ανοιχτό συμβάν του |
PATCH /monitors/{id} |
Ενημέρωση· ο τύπος δεν αλλάζει |
DELETE /monitors/{id} |
Διαγραφή (204) |
POST /monitors/{id}/pause |
Παύση· ένα ανοιχτό συμβάν κλείνει |
POST /monitors/{id}/resume |
Συνέχιση |
GET /check-types |
Τύποι, προεπιλογές και τα όρια του πακέτου σου |
GET /locations |
Ενεργές τοποθεσίες ελέγχου (code, name, country) |
Πεδία κατά τη δημιουργία
| Πεδίο | Περιγραφή |
|---|---|
name |
Όνομα προβολής, έως 255 χαρακτήρες. Υποχρεωτικό. |
type |
Ένας από τους παραπάνω τύπους. Υποχρεωτικό, μετά αμετάβλητο. |
target |
URL, όνομα host, διεύθυνση IP ή domain, ανάλογα με τον τύπο. Υποχρεωτικό εκτός από το heartbeat, που σου δίνει αντί γι αυτό ένα URL ping. |
interval_seconds |
Διάστημα ελέγχου. Το ελάχιστο εξαρτάται από το πακέτο σου· το GET /check-types το επιστρέφει ως limits.min_interval_seconds. |
locations |
Κωδικοί τοποθεσιών, για παράδειγμα ["eu", "sg"]. Πόσες μπορείς να διαλέξεις εξαρτάται από το πακέτο σου. |
primary_location |
Κύρια τοποθεσία που επιβεβαιώνει πρώτη τις διακοπές (Smart Verify). |
confirm_locations |
Πόσες τοποθεσίες πρέπει να δουν την αποτυχία πριν ειδοποιηθείς (1–3). Ρυθμίζεται στα μεγαλύτερα πακέτα. |
confirm_checks |
Πόσοι αποτυχημένοι έλεγχοι στη σειρά επιβεβαιώνουν μια διακοπή (1–3). Ρυθμίζεται στα μεγαλύτερα πακέτα. |
options |
Ανά τύπο. Για http: method (GET, HEAD, POST), expected_status (π.χ. 200-399 ή 200,301), keyword με keyword_mode (present ή absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Οι επιλογές που παραλείπονται παίρνουν τις προεπιλογές από το GET /check-types. |
Δημιούργησε έναν έλεγχο ιστοσελίδας με λέξη-κλειδί:
curl -X POST https://app.centoculus.com/api/v1/monitors \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Shop",
"type": "http",
"target": "https://shop.example.com",
"interval_seconds": 60,
"locations": ["eu", "sg"],
"options": {"keyword": "Add to cart", "expected_status": "200-399"}
}'
Η απάντηση (201) είναι το monitor. Το provisioning.state γίνεται synced μόλις το αναλάβουν οι τοποθεσίες, το status από pending σε up μετά τον πρώτο έλεγχο:
{
"data": {
"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
"customer_id": 1207,
"name": "Shop",
"type": "http",
"target": "https://shop.example.com",
"interval_seconds": 60,
"options": {
"method": "GET",
"expected_status": "200-399",
"keyword": "Add to cart",
"keyword_mode": "present",
"timeout_seconds": 10,
"check_ssl": true,
"warn_days": 14,
"crit_days": 3,
"allow_self_signed": false
},
"location_codes": ["eu", "sg"],
"primary_location": "eu",
"smart_verify": true,
"confirm_locations": 1,
"confirm_checks": 1,
"status": "pending",
"is_paused": false,
"provisioning": {"state": "pending"},
"locations": [
{"code": "eu", "role": "primary", "name": "Europe", "status": "pending", "last_response_ms": null, "last_checked_at": null},
{"code": "sg", "role": "verify", "name": "Singapore", "status": "pending", "last_response_ms": null, "last_checked_at": null}
],
"open_incident": null,
"last_checked_at": null,
"status_changed_at": null,
"created_at": "2026-11-15T08:30:12.000000Z",
"updated_at": "2026-11-15T08:30:12.000000Z"
}
}
Τιμές status: pending, up, degraded, down, paused.
Βάλε ένα monitor σε παύση κατά τη διάρκεια ενός deployment και συνέχισέ το μετά:
curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/pause \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/resume \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
Uptime και χρόνοι απόκρισης
Το uptime υπολογίζεται από διακοπές (συμβάντα σοβαρότητας major)· προειδοποιήσεις όπως ένα πιστοποιητικό που λήγει δεν μετράνε. Μη ελεγμένο ακόμη σημαίνει null, όχι 100.
| Endpoint | Τι κάνει |
|---|---|
GET /monitors/{id}/uptime |
Uptime σε ποσοστό για τις τελευταίες 24 ώρες, 7 ημέρες και 30 ημέρες |
GET /monitors/{id}/daily-uptime |
Uptime ανά ημερολογιακή ημέρα (UTC), days 1–90, προεπιλογή 30 |
GET /monitors/{id}/response-times |
Χρόνος απόκρισης και διαθεσιμότητα ανά τοποθεσία, range 24h, 7d ή 30d· ωριαία σημεία, ημερήσια για 30d |
Uptime:
curl https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/uptime \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{"data": {"24h": 100, "7d": 99.952, "30d": 99.987}}
Χρόνοι απόκρισης (συντομευμένα):
curl "https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/response-times?range=24h" \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": {
"range": "24h",
"locations": {
"eu": [
{"time": "2026-11-15T07:00:00+00:00", "avg_ms": 212.4, "min_ms": 180, "max_ms": 402, "availability": 100},
{"time": "2026-11-15T08:00:00+00:00", "avg_ms": 230.1, "min_ms": 190, "max_ms": 388, "availability": 100}
],
"sg": [
{"time": "2026-11-15T07:00:00+00:00", "avg_ms": 512.8, "min_ms": 470, "max_ms": 790, "availability": 100}
]
}
}
}
Server
Ένας server είναι ένα μηχάνημα με τον agent, ο οποίος αναφέρει CPU, μνήμη, φορτίο, δίσκους, δίκτυο και υπηρεσίες. Η δημιουργία ενός server επιστρέφει την εντολή εγκατάστασης μίας χρήσης· τρέξε την στο μηχάνημα και ο server εμφανίζεται λίγο αργότερα.
| Endpoint | Τι κάνει |
|---|---|
GET /servers |
Λίστα· φίλτρο ids |
POST /servers |
Δημιουργία· η απάντηση περιέχει install_command (Linux) και install_command_freebsd |
GET /servers/{id} |
Ένας server με απογραφή, τελευταίο στιγμιότυπο και όρια |
PATCH /servers/{id} |
Μετονομασία, επιλογή των παρακολουθούμενων services, ορισμός thresholds |
DELETE /servers/{id} |
Διαγραφή (204)· ο agent αφαιρείται από την παρακολούθηση |
POST /servers/{id}/pause |
Παύση· τα ανοιχτά συμβάντα κλείνουν |
POST /servers/{id}/resume |
Συνέχιση |
POST /servers/{id}/install-token |
Νέα εντολή εγκατάστασης· το rotate_key=true εκδίδει και νέο κλειδί agent |
GET /servers/{id}/metrics |
Σειρές γραφημάτων, range 24h, 7d ή 30d: μετρική → πλαίσιο → [unix time, avg, min, max] |
| Πεδίο | Περιγραφή |
|---|---|
name |
Όνομα προβολής, έως 100 χαρακτήρες. Υποχρεωτικό κατά τη δημιουργία. |
services |
Ονόματα υπηρεσιών που πρέπει να παρακολουθεί ο agent, για παράδειγμα ["nginx", "php8.4-fpm", "mariadb"]· έως 200. Ο server αναφέρει ό,τι βρήκε κάτω από το discovered.services. |
thresholds |
Όρια ειδοποίησης: cpu_max (ποσοστό), load_max_per_cpu, mem_min_pavail (ποσοστό ελεύθερης), fs_warn και fs_crit (ποσοστό χρήσης), inode_warn, agent_nodata_minutes, ανά σημείο προσάρτησης κάτω από το filesystems, και οι κανονικές εκφράσεις fs_types, fs_exclude, net_exclude. Οι τιμές που παραλείπονται κρατούν τις προεπιλογές. |
Πρόσθεσε έναν server και διάβασε την εντολή εγκατάστασης από την απάντηση:
curl -X POST https://app.centoculus.com/api/v1/servers \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"name": "web-1"}'
{
"data": {
"id": "a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58",
"customer_id": 1207,
"name": "web-1",
"status": "pending",
"is_paused": false,
"provisioning": {"state": "pending"},
"services": [],
"install_token_expires_at": "2026-11-16T08:30:12.000000Z",
"install_command": "curl -fsSL https://app.centoculus.com/install/K7xQ2mVt9…Rd | sudo sh",
"install_command_freebsd": "fetch -qo - https://app.centoculus.com/install/K7xQ2mVt9…Rd | sh",
"created_at": "2026-11-15T08:30:12.000000Z"
}
}
Παρακολούθησε τρεις υπηρεσίες και ειδοποίησε στο 80 τοις εκατό χρήσης δίσκου:
curl -X PATCH https://app.centoculus.com/api/v1/servers/a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58 \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"services": ["nginx", "php8.4-fpm", "mariadb"],
"thresholds": {"fs_warn": 80, "fs_crit": 90}
}'
Συμβάντα
Ένα συμβάν είναι μία διακοπή ή προειδοποίηση ενός monitor ή server, από το started_at μέχρι το resolved_at. Κάθε συμβάν φέρει τον αριθμό ειδοποίησής του, τον ίδιο που δείχνει το e-mail ειδοποίησης.
| Endpoint | Τι κάνει |
|---|---|
GET /incidents |
Πρώτα τα νεότερα· φίλτρα monitor_id, status (open ή closed), open=1 (ανοιχτές διακοπές χωρίς ανακοινώσεις), from και to (ημερομηνίες) |
GET /incidents/{id} |
Ένα συμβάν με το χρονολόγιό του: πότε έπεσε και πότε ανέκαμψε κάθε τοποθεσία, και η επισκευή που το χειρίστηκε |
Ανοιχτά συμβάντα:
curl "https://app.centoculus.com/api/v1/incidents?status=open&per_page=10" \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": [
{
"id": 90412,
"monitor_id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
"monitor_name": "Shop",
"server_id": null,
"subject_type": "monitor",
"severity": "major",
"cause": "unreachable",
"started_at": "2026-11-15T09:14:03.000000Z",
"resolved_at": null,
"duration_seconds": 241,
"alert_number": 101,
"alert_label": "Incident #101",
"affected_locations": ["eu", "sg"],
"failure_reason": "HTTP 502 instead of 200-399",
"fix": null
}
],
"links": {"first": "…?page=1", "last": "…?page=1", "prev": null, "next": null},
"meta": {"current_page": 1, "from": 1, "last_page": 1, "per_page": 10, "to": 1, "total": 1}
}
Χρήσιμα πεδία: subject_type (monitor ή server), severity (major, warning, info), cause (για παράδειγμα unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations και, όσο είναι ανοιχτό, failure_reason με τις τελευταίες τιμές του ελέγχου.
Σελίδες κατάστασης
Μια σελίδα κατάστασης δείχνει επιλεγμένα monitors στο κοινό ή στην ομάδα σου, κάτω από το δικό μας domain ή το δικό σου. Οι ανακοινώσεις αναγγέλλουν συντήρηση ή εξηγούν ένα συμβάν σε εξέλιξη.
| Endpoint | Τι κάνει |
|---|---|
GET /status-pages |
Λίστα |
POST /status-pages |
Δημιουργία |
GET /status-pages/{id} |
Μία σελίδα με monitors, ανακοινώσεις και την κατάσταση των domains της |
PATCH /status-pages/{id} |
Ενημέρωση· το monitors αντικαθιστά ολόκληρη τη λίστα |
DELETE /status-pages/{id} |
Διαγραφή (204) |
POST /status-pages/{id}/notices |
Προσθήκη ανακοίνωσης |
PUT /status-pages/{id}/notices/{notice} |
Ενημέρωση ανακοίνωσης |
DELETE /status-pages/{id}/notices/{notice} |
Αφαίρεση ανακοίνωσης (204) |
| Πεδίο | Περιγραφή |
|---|---|
slug |
Τμήμα της διεύθυνσης, 3–63 χαρακτήρες, πεζά γράμματα, ψηφία και παύλες· μοναδικό. Υποχρεωτικό. |
title |
Επικεφαλίδα της σελίδας. Υποχρεωτικό. |
description |
Σύντομο κείμενο κάτω από την επικεφαλίδα, έως 2000 χαρακτήρες. |
logo_url |
Διεύθυνση HTTPS ενός λογότυπου. |
custom_domain |
Δικό σου domain όπως το status.example.com· απαιτεί πακέτο με δικά του domains σελίδων κατάστασης. |
is_public |
Δημόσια (true) ή μόνο για συνδεδεμένους χρήστες. |
monitors |
Ταξινομημένη λίστα με {"id": "<monitor UUID>", "display_name": "…", "group": "…"}· τα display_name και group είναι προαιρετικά. |
Μια ανακοίνωση έχει kind (maintenance, info ή incident), title, body (προαιρετικό, έως 5000 χαρακτήρες), starts_at και προαιρετικό ends_at.
Δημιούργησε μια δημόσια σελίδα κατάστασης με δύο monitors:
curl -X POST https://app.centoculus.com/api/v1/status-pages \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"slug": "example-status",
"title": "Example status",
"is_public": true,
"monitors": [
{"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "display_name": "Online shop", "group": "Web"},
{"id": "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f", "group": "Web"}
]
}'
Ανακοίνωσε ένα παράθυρο συντήρησης:
curl -X POST https://app.centoculus.com/api/v1/status-pages/318/notices \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"kind": "maintenance",
"title": "Database upgrade",
"body": "Checkout will be unavailable for about 15 minutes.",
"starts_at": "2026-11-20T01:00:00Z",
"ends_at": "2026-11-20T01:30:00Z"
}'
Κανάλια ειδοποιήσεων
Ένα κανάλι ειδοποιήσεων είναι ένας τρόπος να φτάσεις κάποιον: μια διεύθυνση e-mail, μια συνομιλία Telegram, ένα webhook ή οι συσκευές push ενός χρήστη. Ένα κανάλι λαμβάνει τις ειδοποιήσεις όλων των monitors του workspace ή μόνο των monitors στο monitor_ids. Ποιους τύπους καναλιών περιλαμβάνει το πακέτο σου: GET /notification-channel-types.
| Endpoint | Τι κάνει |
|---|---|
GET /notification-channels |
Λίστα |
POST /notification-channels |
Δημιουργία· για webhook το secret υπογραφής υπάρχει μόνο σε αυτή την απάντηση |
GET /notification-channels/{id} |
Ένα κανάλι |
PATCH /notification-channels/{id} |
Ενημέρωση· ο τύπος δεν αλλάζει |
DELETE /notification-channels/{id} |
Διαγραφή (204) |
POST /notification-channels/{id}/test |
Αποστολή δοκιμαστικής ειδοποίησης (202)· μια μη επιβεβαιωμένη διεύθυνση e-mail παίρνει αντί γι αυτό ξανά τον σύνδεσμο επιβεβαίωσης |
GET /notification-channel-types |
Τύποι καναλιών με available και paid |
| Πεδίο | Περιγραφή |
|---|---|
type |
email, telegram, webhook ή push. Υποχρεωτικό, μετά αμετάβλητο. |
name |
Όνομα προβολής. Υποχρεωτικό. |
config |
Ανά τύπο: {"email": "…"}, {"chat_id": "…"} ή {"url": "https://…"}. Το push δεν χρειάζεται ρύθμιση. Μια νέα διεύθυνση e-mail πρέπει να επιβεβαιωθεί με σύνδεσμο πριν σταλούν ειδοποιήσεις. |
monitor_ids |
UUID των monitors για τα οποία είναι το κανάλι· παράλειψέ το για όλα τα monitors. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: καμία ειδοποίηση σε αυτό το διάστημα. |
escalation_delay_minutes |
Ειδοποίησε αυτό το κανάλι μόνο όταν μια διακοπή διαρκεί τόσο (0–1440). |
notify_recovery |
Στείλε και το μήνυμα αποκατάστασης (true ή false). |
is_active |
Ενεργοποίησε ή απενεργοποίησε το κανάλι χωρίς να το διαγράψεις. |
Δημιούργησε ένα κανάλι webhook για δύο monitors και κράτησε το secret:
curl -X POST https://app.centoculus.com/api/v1/notification-channels \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"type": "webhook",
"name": "Ops bot",
"config": {"url": "https://hooks.example.com/centoculus"},
"monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
"notify_recovery": true
}'
{
"data": {
"id": 512,
"customer_id": 1207,
"type": "webhook",
"name": "Ops bot",
"config": {"url": "https://hooks.example.com/centoculus", "secret": "wq7Hc2…48 characters…Zp"},
"quiet_hours": null,
"escalation_delay_minutes": 0,
"notify_recovery": true,
"is_active": true,
"confirmed": true,
"monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
"created_at": "2026-11-15T08:41:55.000000Z",
"updated_at": "2026-11-15T08:41:55.000000Z"
}
}
Payload του webhook
Ένα κανάλι webhook στέλνει με POST κάθε ειδοποίηση ως JSON στο URL σου, με timeout 10 δευτερολέπτων και χωρίς ανακατευθύνσεις. Ο προορισμός πρέπει να είναι δημόσια διεύθυνση.
Κεφαλίδες: X-Webhook-Timestamp (Unix time), X-Webhook-Signature (sha256= ακολουθούμενο από το HMAC-SHA256 του <timestamp>.<body> με το secret του καναλιού ως κλειδί) και User-Agent: Uptime-Webhook/1.
Το event είναι down, recovered, paused ή test. Για ειδοποίηση monitor το σώμα περιέχει monitor (id, name, target) και incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations)· για ειδοποίηση server server (id, name) και incident με problem αντί για τις τοποθεσίες. Το subject είναι ο τίτλος της ειδοποίησης στη γλώσσα του καναλιού.
Σώμα μιας ειδοποίησης down:
POST /your-endpoint HTTP/1.1
Content-Type: application/json
User-Agent: Uptime-Webhook/1
X-Webhook-Timestamp: 1794912843
X-Webhook-Signature: sha256=3f1b9c…e2a7
{
"event": "down",
"monitor": {"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "name": "Shop", "target": "https://shop.example.com"},
"incident": {
"id": 90412,
"severity": "major",
"cause": "unreachable",
"started_at": "2026-11-15T09:14:03+00:00",
"resolved_at": null,
"duration_seconds": 0,
"affected_locations": ["eu", "sg"]
},
"subject": "DOWN: Shop"
}
Επαλήθευσε την υπογραφή πριν εμπιστευτείς το σώμα: υπολόγισε το HMAC πάνω στο ακατέργαστο σώμα ακριβώς όπως ελήφθη και σύγκρινέ το σε σταθερό χρόνο. Απέρριψε χρονοσφραγίδες παλαιότερες από λίγα λεπτά.
Έλεγχος της υπογραφής σε shell:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Σύνοψη dashboard
Το GET /dashboard επιστρέφει τους αριθμούς πίσω από τα πλακίδια της επισκόπησης: monitors ανά status (οι server μετρούν με τις μονάδες πακέτου τους), server ανά status και τον αριθμό των ανοιχτών συμβάντων. Οποιοδήποτε από τα monitors:read, servers:read ή incidents:read το ανοίγει.
curl https://app.centoculus.com/api/v1/dashboard \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": {
"monitors": {"pending": 0, "up": 46, "degraded": 1, "down": 1, "paused": 2},
"monitors_total": 50,
"servers": {"pending": 0, "up": 3, "degraded": 0, "down": 0, "paused": 0},
"open_incidents": 2
}
}
Συχνές ερωτήσεις
Ποιο πακέτο περιλαμβάνει το API;
Τα API tokens περιλαμβάνονται στο πακέτο Business και πάνω. Στα μικρότερα πακέτα βλέπεις την ενότητα στο Ο λογαριασμός μου, γκριζαρισμένη με σύνδεσμο αναβάθμισης. Όλα τα υπόλοιπα στο Centoculus λειτουργούν χωρίς το API.
Μπορεί ένα token να κάνει ό,τι μπορεί ο λογαριασμός μου;
Όχι. Ένα token φτάνει μόνο στις περιοχές για τις οποίες του έδωσες scopes και ποτέ στη χρέωση, στα μέλη της ομάδας, σε άλλα tokens, στην ασφάλεια του λογαριασμού ή στις επισκευές. Αυτά μένουν στην εφαρμογή.
Υπάρχει sandbox;
Χρησιμοποίησε ένα token μόνο με scopes ανάγνωσης για να εξερευνήσεις και δημιούργησε δοκιμαστικά monitors στο δωρεάν πακέτο ενός δεύτερου λογαριασμού. Τα monitors που δημιουργείς μετράνε στο πακέτο σου όπως αυτά που φτιάχνονται στην εφαρμογή.
Πώς φέρνω τις ειδοποιήσεις στο δικό μου σύστημα;
Δημιούργησε ένα κανάλι webhook και επαλήθευε την υπογραφή κάθε παράδοσης. Κάθε διακοπή, αποκατάσταση και παύση φτάνει στο URL σου μέσα σε δευτερόλεπτα, με το monitor, την αιτία και τις επηρεαζόμενες τοποθεσίες ως JSON.
Αλλάζει το API;
Η έκδοση βρίσκεται στη διεύθυνση (/api/v1). Νέα πεδία μπορεί να προστεθούν στις απαντήσεις οποιαδήποτε στιγμή· μέσα σε μια έκδοση τα πεδία δεν αφαιρούνται ούτε μετονομάζονται. Διάβασε ό,τι χρειάζεσαι και αγνόησε τα υπόλοιπα.
Έτοιμος να αυτοματοποιήσεις την παρακολούθησή σου;
Τα API tokens περιλαμβάνονται στο πακέτο Business και πάνω. Σύγκρινε τα πακέτα ή ξεκίνα δωρεάν και αναβάθμισε όταν τα scripts σου είναι έτοιμα.