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.
- Utwórz token w Moje konto → Tokeny API w aplikacji webowej lub mobilnej i wybierz jego zakresy.
- Skopiuj token od razu; wyświetla się tylko raz.
- 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.
| Zakres | Uprawnienia |
|---|---|
monitors:read | Lista i podgląd monitorów, dostępność, dostępność dzienna, czasy odpowiedzi, typy kontroli, lokalizacje, podsumowanie dashboardu |
monitors:write | Tworzenie, edycja, usuwanie, wstrzymywanie i wznawianie monitorów |
servers:read | Lista i podgląd serwerów oraz ich metryk |
servers:write | Tworzenie, edycja, usuwanie, wstrzymywanie i wznawianie serwerów; nowe polecenie instalacji agenta |
incidents:read | Lista i podgląd incydentów, podsumowanie dashboardu |
status-pages:read | Lista i podgląd stron statusu |
status-pages:write | Tworzenie, edycja i usuwanie stron statusu oraz ich komunikatów |
notifications:read | Lista i podgląd kanałów powiadomień oraz typów kanałów |
notifications:write | Tworzenie, 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 wdatawraz zlinksimeta. - 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
pageiper_page;metazawieracurrent_page,last_page,per_pageitotal. 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_idprzy 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.
| Status | Znaczenie |
|---|---|
401 | Brak tokenu albo token nieprawidłowy, wygasły lub unieważniony. |
402 | Monitoring jest wstrzymany, bo wyczerpało się saldo przedpłacone (klienci resellera); wznawia się po doładowaniu. |
403 | Token nie ma wymaganego zakresu, endpoint jest zamknięty dla tokenów API albo Twój plan nie obejmuje tej funkcji. |
404 | Nie znaleziono albo zasób nie należy do Twojej przestrzeni roboczej. |
409 | Konflikt, na przykład potwierdzanie adresu e-mail, który jest już potwierdzony. |
422 | Walidacja nie powiodła się; zobacz errors. Gdy osiągnięty zostanie limit planu, upgrade wskazuje funkcję, którą odblokowuje wyższy plan. |
429 | Zbyt 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.
| Endpoint | Dział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
| Pole | Opis |
|---|---|
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.
| Endpoint | Dział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.
| Endpoint | Dział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] |
| Pole | Opis |
|---|---|
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.
| Endpoint | Dział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.
| Endpoint | Dział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) |
| Pole | Opis |
|---|---|
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.
| Endpoint | Dział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 |
| Pole | Opis |
|---|---|
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.