API pre uptime monitoring
Všetko, čo robíte v aplikácii, zvládnete aj cez REST API: vytvárajte monitory z deployment pipeline, prenášajte uptime a časy odozvy do vlastných dashboardov, udržiavajte stavové stránky a kanály upozornení v synchronizácii. JSON na vstupe, JSON na výstupe, jeden token Bearer. API tokeny sú súčasťou tarify Business a vyšších.
Začíname
Základná URL
https://app.centoculus.com/api/v1
Každá požiadavka nesie dve hlavičky: Authorization: Bearer <token> a Accept: application/json. Požiadavky s telom posielajú JSON s hlavičkou Content-Type: application/json.
- Vytvorte token v časti Môj účet → API tokeny vo webovej alebo mobilnej aplikácii a zvoľte jeho scopes.
- Token si hneď skopírujte; zobrazí sa iba raz.
- Zavolajte
GET /me. Funguje s každým tokenom a povie vám, komu token patrí.
Vaše prvé volanie:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
Odpoveďou je váš používateľ s rolou, jazykom a workspaces, ku ktorým token siaha (skrátené):
{
"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 a scopes
Token má názov, voliteľnú platnosť (až 730 dní) a scopes, ktoré smie používať. Vyberajte len scopes, ktoré integrácia potrebuje: dashboard dostane monitors:read a incidents:read, deployment skript dostane monitors:write. V tarifách pod Business je táto sekcia viditeľná, ale sivá.
| Scope | Povoľuje |
|---|---|
monitors:read | Výpis a detail monitorov, uptime, denný uptime, časy odozvy, typy kontrol, lokality, súhrn dashboardu |
monitors:write | Vytváranie, úprava, mazanie, pozastavenie a obnovenie monitorov |
servers:read | Výpis a detail serverov a ich metrík |
servers:write | Vytváranie, úprava, mazanie, pozastavenie a obnovenie serverov; nový inštalačný príkaz pre agenta |
incidents:read | Výpis a detail incidentov, súhrn dashboardu |
status-pages:read | Výpis a detail stavových stránok |
status-pages:write | Vytváranie, úprava a mazanie stavových stránok a ich oznámení |
notifications:read | Výpis a detail kanálov upozornení a typov kanálov |
notifications:write | Vytváranie, úprava a mazanie kanálov (e-mail, Telegram, webhook, push), odoslanie testu |
GET /me funguje s každým tokenom. Fakturácia, tím, tokeny, zabezpečenie účtu a opravy nie sú cez API token dostupné a odpovedajú 403, rovnako ako volanie bez zodpovedajúceho scope.
Token zrušíte na rovnakom mieste; prestane fungovať okamžite.
Konvencie
- Odpovede sú vo formáte JSON. Jeden objekt prichádza pod kľúčom
data, zoznam poddataspolu slinksameta. - Monitory a servery sa adresujú cez UUID; incidenty, stavové stránky a kanály upozornení cez číselné id.
- Časy sú vo formáte ISO 8601 v UTC, napríklad
2026-11-15T08:30:00.000000Z. - Zoznamy sa stránkujú pomocou parametrov dotazu
pageaper_page;metaobsahujecurrent_page,last_page,per_pageatotal. Predvolené veľkosti stránok: monitory 15 (max. 200), incidenty 25 (max. 100), kanály upozornení 50, servery 100, stavové stránky 15. - Účty s viacerými workspaces (partneri a resellery) pri vytváraní čohokoľvek odovzdávajú
customer_ida môžu ním filtrovať zoznamy. Zákaznícke účty ho vynechávajú. - Všeobecný limit požiadaviek neexistuje. Niekoľko endpointov je obmedzených, napríklad opakované odoslanie potvrdenia e-mailu (10 za minútu); odpovedajú 429 s hlavičkou
Retry-After. Dopytujte sa najviac tak často, ako bežia kontroly; pre dáta v reálnom čase použite kanál webhook.
Chyby
Chyby sú JSON so správou message. Chyby validácie pridávajú errors s jedným zoznamom správ pre každé pole.
| Status | Význam |
|---|---|
401 | Chýbajúci, neplatný, expirovaný alebo zrušený token. |
402 | Monitoring je pozastavený, pretože sa vyčerpal prepaid zostatok (zákazníci resellerov); po dobití sa obnoví. |
403 | Tokenu chýba scope, endpoint je pre API tokeny uzavretý, alebo váš tarif danú funkciu neobsahuje. |
404 | Nenájdené, alebo mimo vášho workspace. |
409 | Konflikt, napríklad potvrdenie e-mailovej adresy, ktorá je už potvrdená. |
422 | Validácia zlyhala; pozri errors. Ak narazíte na limit tarify, upgrade pomenuje funkciu, ktorú odomkne vyšší tarif. |
429 | Príliš veľa požiadaviek na obmedzený endpoint; počkajte Retry-After sekúnd. |
Chyba validácie:
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 je jedna kontrola: web, certifikát SSL, ping, port TCP, záznam DNS, heartbeat úlohy cron alebo nastavenie pošty domény. Typy: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types vám povie, ktoré typy, intervaly a lokality váš tarif zahŕňa, a tiež predvolené hodnoty každého typu.
| Endpoint | Čo robí |
|---|---|
GET /monitors |
Výpis; filtre status, search, ids (oddelené čiarkou), with_stats=1 pridá uptime a posledný čas odozvy |
POST /monitors |
Vytvorenie; kontroly sa spustia na pozadí |
GET /monitors/{id} |
Jeden monitor s lokalitami a otvoreným incidentom |
PATCH /monitors/{id} |
Úprava; typ sa nedá zmeniť |
DELETE /monitors/{id} |
Zmazanie (204) |
POST /monitors/{id}/pause |
Pozastavenie; otvorený incident sa uzavrie |
POST /monitors/{id}/resume |
Obnovenie |
GET /check-types |
Typy, predvolené hodnoty a limity vášho tarifu |
GET /locations |
Aktívne lokality kontrol (code, name, country) |
Polia pri vytváraní
| Pole | Popis |
|---|---|
name |
Zobrazovaný názov, najviac 255 znakov. Povinné. |
type |
Jeden z vyššie uvedených typov. Povinné, potom nemenné. |
target |
URL, názov hostiteľa, IP adresa alebo doména podľa typu. Povinné okrem heartbeat, ktorý namiesto toho vracia ping URL. |
interval_seconds |
Interval kontroly. Minimum závisí od vášho tarifu; GET /check-types ho vracia ako limits.min_interval_seconds. |
locations |
Kódy lokalít, napríklad ["eu", "sg"]. Koľko ich smiete zvoliť, závisí od vášho tarifu. |
primary_location |
Hlavná lokalita, ktorá výpadky potvrdzuje ako prvá (Smart Verify). |
confirm_locations |
Koľko lokalít musí vidieť zlyhanie, kým dostanete upozornenie (1–3). Vo vyšších tarifách sa dá nastaviť. |
confirm_checks |
Koľko neúspešných kontrol za sebou potvrdí výpadok (1–3). Vo vyšších tarifách sa dá nastaviť. |
options |
Podľa typu. Pre http: method (GET, HEAD, POST), expected_status (napr. 200-399 alebo 200,301), keyword s keyword_mode (present alebo absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Vynechané voľby prevezmú predvolené hodnoty z GET /check-types. |
Vytvorenie kontroly webu s kľúčovým slovom:
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"}
}'
Odpoveďou (201) je monitor. provisioning.state prejde na synced, hneď ako ho lokality prevezmú, status z pending na up po prvej kontrole:
{
"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"
}
}
Hodnoty statusu: pending, up, degraded, down, paused.
Pozastavte monitor počas nasadenia a potom ho obnovte:
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 a časy odozvy
Uptime sa počíta z výpadkov (incidentov so závažnosťou major); varovania, napríklad blížiaci sa koniec platnosti certifikátu, sa nepočítajú. Zatiaľ nekontrolované znamená null, nie 100.
| Endpoint | Čo robí |
|---|---|
GET /monitors/{id}/uptime |
Uptime v percentách za posledných 24 hodín, 7 dní a 30 dní |
GET /monitors/{id}/daily-uptime |
Uptime za kalendárny deň (UTC), days 1–90, predvolené 30 |
GET /monitors/{id}/response-times |
Čas odozvy a dostupnosť podľa lokality, range 24h, 7d alebo 30d; hodinové body, pri 30d denné |
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}}
Časy odozvy (skrátené):
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}
]
}
}
}
Servery
Server je stroj s nainštalovaným agentom, ktorý hlási CPU, pamäť, záťaž, disky, sieť a služby. Vytvorenie servera vráti jednorazový inštalačný príkaz; spustite ho na stroji a server sa o chvíľu objaví.
| Endpoint | Čo robí |
|---|---|
GET /servers |
Výpis; filter ids |
POST /servers |
Vytvorenie; odpoveď obsahuje install_command (Linux) a install_command_freebsd |
GET /servers/{id} |
Jeden server s inventárom, posledným snímkom a prahovými hodnotami |
PATCH /servers/{id} |
Premenovanie, výber sledovaných services, nastavenie thresholds |
DELETE /servers/{id} |
Zmazanie (204); agent sa odoberie z monitoringu |
POST /servers/{id}/pause |
Pozastavenie; otvorené incidenty sa uzavrú |
POST /servers/{id}/resume |
Obnovenie |
POST /servers/{id}/install-token |
Nový inštalačný príkaz; rotate_key=true vydá aj nový kľúč agenta |
GET /servers/{id}/metrics |
Rady grafov, range 24h, 7d alebo 30d: metrika → kontext → [unix time, avg, min, max] |
| Pole | Popis |
|---|---|
name |
Zobrazovaný názov, najviac 100 znakov. Pri vytváraní povinné. |
services |
Názvy služieb, ktoré má agent sledovať, napríklad ["nginx", "php8.4-fpm", "mariadb"]; najviac 200. Server hlási, čo našiel, pod discovered.services. |
thresholds |
Prahové hodnoty upozornení: cpu_max (percentá), load_max_per_cpu, mem_min_pavail (percentá voľné), fs_warn a fs_crit (percentá využitia), inode_warn, agent_nodata_minutes, podľa pripojného bodu pod filesystems, a regulárne výrazy fs_types, fs_exclude, net_exclude. Vynechané hodnoty si ponechajú predvolené nastavenie. |
Pridajte server a z odpovede prečítajte inštalačný príkaz:
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"
}
}
Sledujte tri služby a upozornite pri 80 percentách využitia disku:
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}
}'
Incidenty
Incident je jeden výpadok alebo varovanie monitora či servera, od started_at do resolved_at. Každý incident nesie svoje číslo upozornenia, rovnaké, aké ukazuje e-mail s upozornením.
| Endpoint | Čo robí |
|---|---|
GET /incidents |
Najnovšie prvé; filtre monitor_id, status (open alebo closed), open=1 (otvorené výpadky bez oznámení), from a to (dátumy) |
GET /incidents/{id} |
Jeden incident s časovou osou: kedy ktorá lokalita prestala fungovať a kedy sa zotavila, a oprava, ktorá ho vyriešila |
Otvorené incidenty:
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}
}
Užitočné polia: subject_type (monitor alebo server), severity (major, warning, info), cause (napríklad unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations a pri otvorenom incidente failure_reason s najnovšími hodnotami kontroly.
Stavové stránky
Stavová stránka ukazuje vybrané monitory verejnosti alebo vášmu tímu, na našej doméne alebo na vašej vlastnej. Oznámenia ohlasujú údržbu alebo vysvetľujú prebiehajúci incident.
| Endpoint | Čo robí |
|---|---|
GET /status-pages |
Výpis |
POST /status-pages |
Vytvorenie |
GET /status-pages/{id} |
Jedna stránka s monitormi, oznámeniami a stavom jej domén |
PATCH /status-pages/{id} |
Úprava; monitors nahradí celý zoznam |
DELETE /status-pages/{id} |
Zmazanie (204) |
POST /status-pages/{id}/notices |
Pridanie oznámenia |
PUT /status-pages/{id}/notices/{notice} |
Úprava oznámenia |
DELETE /status-pages/{id}/notices/{notice} |
Odstránenie oznámenia (204) |
| Pole | Popis |
|---|---|
slug |
Časť adresy, 3–63 znakov, malé písmená, číslice a spojovníky; jedinečná. Povinné. |
title |
Nadpis stránky. Povinné. |
description |
Krátky text pod nadpisom, najviac 2000 znakov. |
logo_url |
Adresa loga cez HTTPS. |
custom_domain |
Vlastná doména, napríklad status.example.com; vyžaduje tarif s vlastnými doménami stavových stránok. |
is_public |
Verejná (true), alebo len pre prihlásených používateľov. |
monitors |
Usporiadaný zoznam {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name a group sú voliteľné. |
Oznámenie má kind (maintenance, info alebo incident), title, body (voliteľné, najviac 5000 znakov), starts_at a voliteľné ends_at.
Vytvorenie verejnej stavovej stránky s dvoma monitormi:
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"}
]
}'
Ohlásenie servisného okna:
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"
}'
Kanály upozornení
Kanál upozornení je jeden spôsob, ako niekoho zastihnúť: e-mailová adresa, chat v Telegrame, webhook alebo push zariadenia používateľa. Kanál prijíma upozornenia všetkých monitorov workspace, alebo len monitorov v monitor_ids. Ktoré typy kanálov váš tarif zahŕňa, zistíte cez GET /notification-channel-types.
| Endpoint | Čo robí |
|---|---|
GET /notification-channels |
Výpis |
POST /notification-channels |
Vytvorenie; pri webhooku je podpisové secret iba v tejto odpovedi |
GET /notification-channels/{id} |
Jeden kanál |
PATCH /notification-channels/{id} |
Úprava; typ sa nedá zmeniť |
DELETE /notification-channels/{id} |
Zmazanie (204) |
POST /notification-channels/{id}/test |
Odoslanie testovacieho upozornenia (202); nepotvrdená e-mailová adresa namiesto toho znova dostane potvrdzovací odkaz |
GET /notification-channel-types |
Typy kanálov s available a paid |
| Pole | Popis |
|---|---|
type |
email, telegram, webhook alebo push. Povinné, potom nemenné. |
name |
Zobrazovaný názov. Povinné. |
config |
Podľa typu: {"email": "…"}, {"chat_id": "…"} alebo {"url": "https://…"}. Push žiadnu konfiguráciu nepotrebuje. Nová e-mailová adresa musí byť pred odoslaním upozornení potvrdená odkazom. |
monitor_ids |
UUID monitorov, pre ktoré je kanál určený; pre všetky monitory pole vynechajte. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: v tomto okne žiadne upozornenia. |
escalation_delay_minutes |
Upozorniť tento kanál, až keď výpadok trvá takto dlho (0–1440). |
notify_recovery |
Poslať aj správu o obnovení (true alebo false). |
is_active |
Kanál zapnúť alebo vypnúť bez zmazania. |
Vytvorenie kanála webhook pre dva monitory a uloženie 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 webhooku
Kanál webhook odosiela každé upozornenie ako JSON cez POST na vašu URL, s timeoutom 10 sekúnd a bez presmerovaní. Cieľ musí byť verejná adresa.
Hlavičky: X-Webhook-Timestamp (Unix time), X-Webhook-Signature (sha256= nasledované HMAC-SHA256 z <timestamp>.<body> so secret kanála ako kľúčom) a User-Agent: Uptime-Webhook/1.
event je down, recovered, paused alebo test. Pri upozornení na monitor telo obsahuje monitor (id, name, target) a incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); pri upozornení na server server (id, name) a incident s problem namiesto lokalít. subject je nadpis upozornenia v jazyku kanála.
Telo upozornenia 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"
}
Podpis overte skôr, než telu uveríte: vypočítajte HMAC zo surového tela presne tak, ako dorazilo, a porovnajte ho v konštantnom čase. Odmietnite časové pečiatky staršie ako niekoľko minút.
Kontrola podpisu v shelli:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Súhrn dashboardu
GET /dashboard vracia počty za dlaždicami prehľadu: monitory podľa statusu (servery sa počítajú so svojimi jednotkami tarify), servery podľa statusu a počet otvorených incidentov. Otvorí ho ktorýkoľvek zo scopes monitors:read, servers:read alebo 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
}
}
Často kladené otázky
Ktorý tarif zahŕňa API?
API tokeny sú súčasťou tarify Business a vyšších. V menších tarifách sekciu vidíte v časti Môj účet sivú s odkazom na upgrade. Všetko ostatné v Centoculus funguje aj bez API.
Zvládne jeden token všetko, čo môj účet?
Nie. Token siaha len na oblasti, pre ktoré ste mu dali scopes, a nikdy na fakturáciu, členov tímu, iné tokeny, zabezpečenie účtu ani opravy. Tie ostávajú v aplikácii.
Existuje sandbox?
Na preskúmanie použite token len s read scopes a testovacie monitory vytvárajte v bezplatnom tarife druhého účtu. Monitory, ktoré vytvoríte, sa počítajú do vášho tarifu rovnako ako tie z aplikácie.
Ako dostanem upozornenia do vlastného systému?
Vytvorte kanál webhook a pri každom doručení overte podpis. Každý výpadok, obnovenie aj pozastavenie dorazí na vašu URL v priebehu pár sekúnd, s monitorom, príčinou a dotknutými lokalitami ako JSON.
Mení sa API?
Verzia je súčasťou adresy (/api/v1). Do odpovedí môžu byť kedykoľvek pridané nové polia; v rámci verzie sa polia neodoberajú ani nepremenúvajú. Čítajte, čo potrebujete, a zvyšok ignorujte.
Chcete automatizovať svoj monitoring?
API tokeny sú súčasťou tarify Business a vyšších. Porovnajte tarify, alebo začnite zadarmo a prejdite na vyšší, keď budú vaše skripty hotové.