Przejdź do treści
Centoculus

API do monitoringu dostępności

Wszystko, co robisz w aplikacji, zrobisz też przez REST API: twórz monitory z własnego pipeline'u wdrożeniowego, pobieraj dostępność i czasy odpowiedzi do własnych dashboardów, synchronizuj strony statusu i kanały alertów. JSON na wejściu, JSON na wyjściu, jeden token Bearer. Tokeny API są dostępne od planu Business.

Pierwsze kroki

Adres bazowy

https://app.centoculus.com/api/v1

Każde żądanie zawiera dwa nagłówki: Authorization: Bearer <token> i Accept: application/json. Żądania z treścią wysyłają JSON z nagłówkiem Content-Type: application/json.

  1. Utwórz token w Moje konto → Tokeny API w aplikacji webowej lub mobilnej i wybierz jego zakresy.
  2. Skopiuj token od razu; wyświetla się tylko raz.
  3. Wywołaj GET /me. Działa z każdym tokenem i pokazuje, do kogo token należy.

Twoje pierwsze wywołanie:

curl https://app.centoculus.com/api/v1/me \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json"

Odpowiedź zawiera Twojego użytkownika z rolą, językiem i przestrzeniami roboczymi, do których token ma dostęp (skrócone):

{
  "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
  }
}

Tokeny i zakresy

Token ma nazwę, opcjonalną datę wygaśnięcia (do 730 dni) i zakresy, z których może korzystać. Wybieraj tylko te zakresy, których integracja naprawdę potrzebuje: dashboard dostaje monitors:read i incidents:read, skrypt wdrożeniowy dostaje monitors:write. W planach niższych niż Business sekcja jest widoczna, ale nieaktywna.

ZakresUprawnienia
monitors:readLista i podgląd monitorów, dostępność, dostępność dzienna, czasy odpowiedzi, typy kontroli, lokalizacje, podsumowanie dashboardu
monitors:writeTworzenie, edycja, usuwanie, wstrzymywanie i wznawianie monitorów
servers:readLista i podgląd serwerów oraz ich metryk
servers:writeTworzenie, edycja, usuwanie, wstrzymywanie i wznawianie serwerów; nowe polecenie instalacji agenta
incidents:readLista i podgląd incydentów, podsumowanie dashboardu
status-pages:readLista i podgląd stron statusu
status-pages:writeTworzenie, edycja i usuwanie stron statusu oraz ich komunikatów
notifications:readLista i podgląd kanałów powiadomień oraz typów kanałów
notifications:writeTworzenie, edycja i usuwanie kanałów (e-mail, Telegram, webhook, push), wysyłanie testu

GET /me działa z każdym tokenem. Rozliczenia, zespół, tokeny, bezpieczeństwo konta i naprawy są niedostępne dla tokenów API i zwracają 403, podobnie jak wywołanie bez odpowiedniego zakresu.

Token unieważnisz w tym samym miejscu; przestaje działać natychmiast.

Konwencje

  • Odpowiedzi są w formacie JSON. Pojedynczy obiekt znajduje się w data, lista w data wraz z links i meta.
  • Monitory i serwery są adresowane przez UUID; incydenty, strony statusu i kanały powiadomień przez numeryczne id.
  • Czasy mają format ISO 8601 w UTC, na przykład 2026-11-15T08:30:00.000000Z.
  • Listy są stronicowane parametrami zapytania page i per_page; meta zawiera current_page, last_page, per_page i total. Domyślne rozmiary stron: monitory 15 (maks. 200), incydenty 25 (maks. 100), kanały powiadomień 50, serwery 100, strony statusu 15.
  • Konta z wieloma przestrzeniami roboczymi (partnerzy i resellerzy) podają customer_id przy tworzeniu zasobów i mogą nim filtrować listy. Konta klientów go pomijają.
  • Nie ma ogólnego limitu żądań. Kilka endpointów jest ograniczonych, na przykład ponowne wysłanie potwierdzenia e-mail (10 na minutę); odpowiadają wtedy kodem 429 z nagłówkiem Retry-After. Odpytuj API nie częściej niż wynosi interwał kontroli; dla danych na żywo użyj kanału webhook.

Błędy

Błędy mają postać JSON z polem message. Błędy walidacji dodają errors z listą komunikatów dla każdego pola.

StatusZnaczenie
401Brak tokenu albo token nieprawidłowy, wygasły lub unieważniony.
402Monitoring jest wstrzymany, bo wyczerpało się saldo przedpłacone (klienci resellera); wznawia się po doładowaniu.
403Token nie ma wymaganego zakresu, endpoint jest zamknięty dla tokenów API albo Twój plan nie obejmuje tej funkcji.
404Nie znaleziono albo zasób nie należy do Twojej przestrzeni roboczej.
409Konflikt, na przykład potwierdzanie adresu e-mail, który jest już potwierdzony.
422Walidacja nie powiodła się; zobacz errors. Gdy osiągnięty zostanie limit planu, upgrade wskazuje funkcję, którą odblokowuje wyższy plan.
429Zbyt wiele żądań do ograniczanego endpointu; poczekaj tyle sekund, ile wskazuje Retry-After.

Błąd walidacji:

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."]
  }
}

Monitory

Monitor to jedna kontrola: strona internetowa, certyfikat SSL, ping, port TCP, rekord DNS, heartbeat zadania cron albo konfiguracja poczty domeny. Typy: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types zwraca typy, interwały i lokalizacje dostępne w Twoim planie oraz wartości domyślne każdego typu.

EndpointDziałanie
GET /monitors Lista; filtry status, search, ids (rozdzielone przecinkami), with_stats=1 dodaje dostępność i ostatni czas odpowiedzi
POST /monitors Tworzenie; kontrole startują w tle
GET /monitors/{id} Jeden monitor z lokalizacjami i otwartym incydentem
PATCH /monitors/{id} Aktualizacja; typu nie można zmienić
DELETE /monitors/{id} Usunięcie (204)
POST /monitors/{id}/pause Wstrzymanie; otwarty incydent zostaje zamknięty
POST /monitors/{id}/resume Wznowienie
GET /check-types Typy, wartości domyślne i limity Twojego planu
GET /locations Aktywne lokalizacje kontroli (code, name, country)

Pola przy tworzeniu

PoleOpis
name Nazwa wyświetlana, do 255 znaków. Wymagane.
type Jeden z typów podanych wyżej. Wymagane, potem niezmienne.
target URL, nazwa hosta, adres IP lub domena, zależnie od typu. Wymagane, z wyjątkiem heartbeat, który zamiast tego daje Ci URL do pingowania.
interval_seconds Interwał kontroli. Minimum zależy od planu; GET /check-types zwraca je jako limits.min_interval_seconds.
locations Kody lokalizacji, na przykład ["eu", "sg"]. Ile lokalizacji możesz wybrać, zależy od planu.
primary_location Lokalizacja główna, która jako pierwsza potwierdza awarie (Smart Verify).
confirm_locations Ile lokalizacji musi zobaczyć awarię, zanim dostaniesz alert (1–3). Konfigurowalne w wyższych planach.
confirm_checks Ile nieudanych kontroli z rzędu potwierdza awarię (1–3). Konfigurowalne w wyższych planach.
options Zależnie od typu. Dla http: method (GET, HEAD, POST), expected_status (np. 200-399 lub 200,301), keyword z keyword_mode (present lub absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Pominięte opcje przyjmują wartości domyślne z GET /check-types.

Utwórz kontrolę strony ze słowem kluczowym:

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"}
  }'

Odpowiedzią (201) jest monitor. provisioning.state zmienia się na synced, gdy tylko lokalizacje go przejmą, a status z pending na up po pierwszej kontroli:

{
  "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"
  }
}

Wartości statusu: pending, up, degraded, down, paused.

Wstrzymaj monitor na czas wdrożenia i wznów go po jego zakończeniu:

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"

Dostępność i czasy odpowiedzi

Dostępność jest liczona na podstawie awarii (incydentów o ważności major); ostrzeżenia, takie jak wygasający certyfikat, nie są wliczane. Brak jeszcze kontroli oznacza null, a nie 100.

EndpointDziałanie
GET /monitors/{id}/uptime Dostępność w procentach z ostatnich 24 godzin, 7 dni i 30 dni
GET /monitors/{id}/daily-uptime Dostępność dla każdego dnia kalendarzowego (UTC), days 1–90, domyślnie 30
GET /monitors/{id}/response-times Czas odpowiedzi i dostępność dla każdej lokalizacji, range 24h, 7d lub 30d; punkty godzinowe, dla 30d dzienne

Dostępność:

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}}

Czasy odpowiedzi (skrócone):

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}
      ]
    }
  }
}

Serwery

Serwer to maszyna z zainstalowanym agentem, który raportuje CPU, pamięć, obciążenie, dyski, sieć i usługi. Utworzenie serwera zwraca jednorazowe polecenie instalacji; uruchom je na maszynie, a serwer pojawi się po chwili.

EndpointDziałanie
GET /servers Lista; filtr ids
POST /servers Tworzenie; odpowiedź zawiera install_command (Linux) i install_command_freebsd
GET /servers/{id} Jeden serwer z inwentarzem, ostatnim zrzutem stanu i progami
PATCH /servers/{id} Zmiana nazwy, wybór obserwowanych usług services, ustawienie progów thresholds
DELETE /servers/{id} Usunięcie (204); agent zostaje usunięty z monitoringu
POST /servers/{id}/pause Wstrzymanie; otwarte incydenty zostają zamknięte
POST /servers/{id}/resume Wznowienie
POST /servers/{id}/install-token Nowe polecenie instalacji; rotate_key=true wystawia też nowy klucz agenta
GET /servers/{id}/metrics Serie danych do wykresów, range 24h, 7d lub 30d: metryka → kontekst → [unix time, avg, min, max]
PoleOpis
name Nazwa wyświetlana, do 100 znaków. Wymagana przy tworzeniu.
services Nazwy usług, które agent ma obserwować, na przykład ["nginx", "php8.4-fpm", "mariadb"]; do 200. Serwer zgłasza to, co znalazł, w discovered.services.
thresholds Progi alertów: cpu_max (procent), load_max_per_cpu, mem_min_pavail (procent wolnej pamięci), fs_warn i fs_crit (procent zajętego miejsca), inode_warn, agent_nodata_minutes, dla każdego punktu montowania w filesystems oraz wyrażenia regularne fs_types, fs_exclude, net_exclude. Pominięte wartości zachowują domyślne.

Dodaj serwer i odczytaj polecenie instalacji z odpowiedzi:

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"
  }
}

Obserwuj trzy usługi i alarmuj przy 80 procentach zajętości dysku:

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}
  }'

Incydenty

Incydent to jedna awaria lub ostrzeżenie monitora albo serwera, od started_at do resolved_at. Każdy incydent ma numer alertu, taki sam jak w e-mailu z alertem.

EndpointDziałanie
GET /incidents Od najnowszych; filtry monitor_id, status (open lub closed), open=1 (otwarte awarie bez komunikatów), from i to (daty)
GET /incidents/{id} Jeden incydent z osią czasu: kiedy która lokalizacja przestała działać i wróciła do normy, oraz naprawa, która go obsłużyła

Otwarte incydenty:

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}
}

Przydatne pola: subject_type (monitor lub server), severity (major, warning, info), cause (na przykład unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations oraz, dopóki incydent jest otwarty, failure_reason z najnowszymi wartościami kontroli.

Strony statusu

Strona statusu pokazuje wybrane monitory publicznie lub Twojemu zespołowi, pod naszą domeną albo Twoją własną. Komunikaty zapowiadają prace serwisowe lub wyjaśniają trwający incydent.

EndpointDziałanie
GET /status-pages Lista
POST /status-pages Tworzenie
GET /status-pages/{id} Jedna strona z monitorami, komunikatami i stanem jej domen
PATCH /status-pages/{id} Aktualizacja; monitors zastępuje całą listę
DELETE /status-pages/{id} Usunięcie (204)
POST /status-pages/{id}/notices Dodanie komunikatu
PUT /status-pages/{id}/notices/{notice} Aktualizacja komunikatu
DELETE /status-pages/{id}/notices/{notice} Usunięcie komunikatu (204)
PoleOpis
slug Część adresu, 3–63 znaków, małe litery, cyfry i myślniki; unikalna. Wymagane.
title Nagłówek strony. Wymagane.
description Krótki tekst pod nagłówkiem, do 2000 znaków.
logo_url Adres HTTPS logo.
custom_domain Własna domena, np. status.example.com; wymaga planu z własnymi domenami stron statusu.
is_public Publiczna (true) albo tylko dla zalogowanych użytkowników.
monitors Uporządkowana lista {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name i group są opcjonalne.

Komunikat ma kind (maintenance, info lub incident), title, body (opcjonalnie, do 5000 znaków), starts_at i opcjonalne ends_at.

Utwórz publiczną stronę statusu z dwoma monitorami:

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"}
    ]
  }'

Zapowiedz okno serwisowe:

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"
  }'

Kanały powiadomień

Kanał powiadomień to jeden ze sposobów dotarcia do kogoś: adres e-mail, czat na Telegramie, webhook albo urządzenia push użytkownika. Kanał otrzymuje alerty ze wszystkich monitorów przestrzeni roboczej albo tylko z monitorów z monitor_ids. Typy kanałów dostępne w Twoim planie: GET /notification-channel-types.

EndpointDziałanie
GET /notification-channels Lista
POST /notification-channels Tworzenie; dla webhooka klucz podpisu secret znajduje się tylko w tej odpowiedzi
GET /notification-channels/{id} Jeden kanał
PATCH /notification-channels/{id} Aktualizacja; typu nie można zmienić
DELETE /notification-channels/{id} Usunięcie (204)
POST /notification-channels/{id}/test Wysłanie powiadomienia testowego (202); niepotwierdzony adres e-mail dostaje zamiast tego ponownie link potwierdzający
GET /notification-channel-types Typy kanałów z available i paid
PoleOpis
type email, telegram, webhook lub push. Wymagane, potem niezmienne.
name Nazwa wyświetlana. Wymagane.
config Zależnie od typu: {"email": "…"}, {"chat_id": "…"} lub {"url": "https://…"}. Push nie wymaga konfiguracji. Nowy adres e-mail trzeba potwierdzić linkiem, zanim zaczną wychodzić alerty.
monitor_ids UUID monitorów, których dotyczy ten kanał; pomiń, aby objąć wszystkie monitory.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: brak alertów w tym oknie czasowym.
escalation_delay_minutes Alarmuj ten kanał dopiero, gdy awaria trwa tak długo (0–1440).
notify_recovery Wyślij też informację o powrocie do normy (true lub false).
is_active Włącz lub wyłącz kanał bez usuwania.

Utwórz kanał webhook dla dwóch monitorów i zachowaj 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 webhooka

Kanał webhook wysyła każdy alert jako JSON metodą POST na Twój URL, z limitem czasu 10 sekund i bez przekierowań. Cel musi być adresem publicznym.

Nagłówki: X-Webhook-Timestamp (czas Unix), X-Webhook-Signature (sha256= i HMAC-SHA256 z <timestamp>.<body> z sekretem kanału jako kluczem) oraz User-Agent: Uptime-Webhook/1.

event to down, recovered, paused lub test. Dla alertu monitora treść zawiera monitor (id, name, target) i incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); dla alertu serwera server (id, name) i incident z problem zamiast lokalizacji. subject to nagłówek alertu w języku kanału.

Treść alertu o awarii (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"
}

Zweryfikuj podpis, zanim zaufasz treści: oblicz HMAC z surowej treści dokładnie w otrzymanej postaci i porównaj go w stałym czasie. Odrzucaj znaczniki czasu starsze niż kilka minut.

Sprawdzanie podpisu w powłoce:

expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"

Podsumowanie dashboardu

GET /dashboard zwraca liczby stojące za kafelkami przeglądu: monitory według statusu (serwery liczą się razem ze swoimi jednostkami planu), serwery według statusu i liczbę otwartych incydentów. Dostęp daje każdy z zakresów monitors:read, servers:read lub 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
  }
}

Najczęściej zadawane pytania

Który plan obejmuje API?

Tokeny API są dostępne od planu Business. W mniejszych planach widzisz tę sekcję w Moje konto, nieaktywną, z linkiem do ulepszenia planu. Wszystko inne w Centoculus działa bez API.

Czy jeden token może wszystko, co moje konto?

Nie. Token sięga tylko do obszarów, dla których nadano mu zakresy, i nigdy do rozliczeń, członków zespołu, innych tokenów, bezpieczeństwa konta ani napraw. Te rzeczy zostają w aplikacji.

Czy jest piaskownica?

Do poznawania API użyj tokenu tylko z zakresami odczytu, a monitory testowe twórz w darmowym planie drugiego konta. Utworzone monitory wliczają się do Twojego planu tak samo jak te z aplikacji.

Jak przekazać alerty do własnego systemu?

Utwórz kanał webhook i weryfikuj podpis każdego wywołania. Każda awaria, powrót do normy i wstrzymanie trafia na Twój URL w ciągu sekund, z monitorem, przyczyną i dotkniętymi lokalizacjami w JSON.

Czy API się zmienia?

Wersja jest w adresie (/api/v1). Do odpowiedzi mogą w każdej chwili dochodzić nowe pola; w ramach jednej wersji pola nie są usuwane ani przemianowywane. Czytaj to, czego potrzebujesz, a resztę ignoruj.

Gotowy, by zautomatyzować monitoring?

Tokeny API wchodzą w skład planu Business i wyższych. Porównaj plany albo zacznij za darmo i przejdź na wyższy, gdy skrypty będą gotowe.