Μετάβαση στο περιεχόμενο
Centoculus

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.

  1. Δημιούργησε ένα token στο Ο λογαριασμός μου → API tokens στην εφαρμογή ιστού ή στο κινητό και διάλεξε τα scopes του.
  2. Αντίγραψε το token αμέσως· εμφανίζεται μόνο μία φορά.
  3. Κάλεσε το 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Σημασία
401Token που λείπει, δεν είναι έγκυρο, έχει λήξει ή έχει ανακληθεί.
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 σου είναι έτοιμα.