Prejsť na obsah
Centoculus

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.

  1. Vytvorte token v časti Môj účet → API tokeny vo webovej alebo mobilnej aplikácii a zvoľte jeho scopes.
  2. Token si hneď skopírujte; zobrazí sa iba raz.
  3. 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á.

ScopePovoľuje
monitors:readVýpis a detail monitorov, uptime, denný uptime, časy odozvy, typy kontrol, lokality, súhrn dashboardu
monitors:writeVytváranie, úprava, mazanie, pozastavenie a obnovenie monitorov
servers:readVýpis a detail serverov a ich metrík
servers:writeVytváranie, úprava, mazanie, pozastavenie a obnovenie serverov; nový inštalačný príkaz pre agenta
incidents:readVýpis a detail incidentov, súhrn dashboardu
status-pages:readVýpis a detail stavových stránok
status-pages:writeVytváranie, úprava a mazanie stavových stránok a ich oznámení
notifications:readVýpis a detail kanálov upozornení a typov kanálov
notifications:writeVytvá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 pod data spolu s links a meta.
  • 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 page a per_page; meta obsahuje current_page, last_page, per_page a total. 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_id a 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.

StatusVýznam
401Chýbajúci, neplatný, expirovaný alebo zrušený token.
402Monitoring je pozastavený, pretože sa vyčerpal prepaid zostatok (zákazníci resellerov); po dobití sa obnoví.
403Tokenu chýba scope, endpoint je pre API tokeny uzavretý, alebo váš tarif danú funkciu neobsahuje.
404Nenájdené, alebo mimo vášho workspace.
409Konflikt, napríklad potvrdenie e-mailovej adresy, ktorá je už potvrdená.
422Validácia zlyhala; pozri errors. Ak narazíte na limit tarify, upgrade pomenuje funkciu, ktorú odomkne vyšší tarif.
429Prí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í

PolePopis
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]
PolePopis
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)
PolePopis
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
PolePopis
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é.