Ugrás a tartalomhoz
Centoculus

Uptime monitorozás API

Minden, amit az alkalmazásban megtehet, REST API-n keresztül is elérhető: hozzon létre monitorokat a deployment pipeline-ból, vigye át az uptime-ot és a válaszidőket saját dashboardjaiba, tartsa szinkronban a státuszoldalakat és a riasztási csatornákat. JSON be, JSON ki, egyetlen Bearer token. Az API tokenek a Business csomagtól felfelé érhetők el.

Első lépések

Alap URL

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

Minden kérés két fejlécet visel: Authorization: Bearer <token> és Accept: application/json. A törzzsel rendelkező kérések JSON-t küldenek Content-Type: application/json fejléccel.

  1. Hozzon létre egy tokent a Fiókom → API tokenek menüpontban a webes vagy a mobilalkalmazásban, és válassza ki a scope-jait.
  2. Másolja ki a tokent azonnal; csak egyszer jelenik meg.
  3. Hívja meg a GET /me végpontot. Minden tokennel működik, és megmondja, kié a token.

Az első hívás:

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

A válasz az Ön felhasználója szerepkörrel, nyelvvel és azokkal a workspace-ekkel, amelyeket a token elér (rövidítve):

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

Tokenek és scope-ok

A tokennek van neve, opcionális lejárata (legfeljebb 730 nap) és scope-jai, amelyeket használhat. Csak azokat a scope-okat válassza, amelyekre az integrációnak szüksége van: egy dashboard monitors:read és incidents:read jogot kap, egy deployment szkript monitors:write jogot. A Business alatti csomagoknál a szakasz látható, de szürkített.

ScopeEngedélyezi
monitors:readMonitorok listázása és megtekintése, uptime, napi uptime, válaszidők, ellenőrzéstípusok, helyszínek, dashboard összesítő
monitors:writeMonitorok létrehozása, módosítása, törlése, szüneteltetése és folytatása
servers:readSzerverek és metrikáik listázása és megtekintése
servers:writeSzerverek létrehozása, módosítása, törlése, szüneteltetése és folytatása; új telepítési parancs az ügynökhöz
incidents:readIncidensek listázása és megtekintése, dashboard összesítő
status-pages:readStátuszoldalak listázása és megtekintése
status-pages:writeStátuszoldalak és közleményeik létrehozása, módosítása és törlése
notifications:readÉrtesítési csatornák és csatornatípusok listázása és megtekintése
notifications:writeCsatornák (e-mail, Telegram, webhook, push) létrehozása, módosítása és törlése, teszt küldése

A GET /me minden tokennel működik. A számlázás, a csapat, a tokenek, a fiókbiztonság és a javítások API tokennel nem érhetők el, és 403-at adnak, ahogy a megfelelő scope nélküli hívás is.

A tokent ugyanott vonhatja vissza; azonnal megszűnik működni.

Konvenciók

  • A válaszok JSON formátumúak. Egyetlen objektum a data alatt érkezik, a lista a data alatt links és meta mellett.
  • A monitorokat és szervereket UUID-vel, az incidenseket, státuszoldalakat és értesítési csatornákat numerikus id-vel címezzük.
  • Az időpontok ISO 8601 formátumúak, UTC-ben, például 2026-11-15T08:30:00.000000Z.
  • A listák lapozása a page és per_page lekérdezési paraméterekkel történik; a meta tartalmazza a current_page, last_page, per_page és total értékeket. Alapértelmezett lapméretek: monitorok 15 (max. 200), incidensek 25 (max. 100), értesítési csatornák 50, szerverek 100, státuszoldalak 15.
  • A több workspace-szel rendelkező fiókok (partnerek és viszonteladók) létrehozáskor megadják a customer_id értéket, és vele szűrhetik a listákat. Az ügyfélfiókok elhagyják.
  • Általános kérésküszöb nincs. Néhány végpont korlátozott, például az e-mail megerősítésének újraküldése (percenként 10); ezek 429-et adnak Retry-After fejléccel. Ne kérdezzen le gyakrabban, mint az ellenőrzési intervallum; élő adatokhoz használjon webhook csatornát.

Hibák

A hibák JSON-ként érkeznek message mezővel. Az érvényesítési hibák errors mezőt is adnak, mezőnként egy üzenetlistával.

StátuszJelentés
401Hiányzó, érvénytelen, lejárt vagy visszavont token.
402A monitorozás szünetel, mert az előre fizetett egyenleg elfogyott (viszonteladói ügyfelek); feltöltés után folytatódik.
403A tokenből hiányzik a scope, a végpont zárt az API tokenek előtt, vagy a csomag nem tartalmazza a funkciót.
404Nem található, vagy nem az Ön workspace-ében van.
409Ütközés, például egy már megerősített e-mail-cím megerősítése.
422Az érvényesítés sikertelen; lásd errors. Ha csomagkorlátba ütközik, az upgrade megnevezi azt a funkciót, amelyet egy nagyobb csomag felold.
429Túl sok kérés egy korlátozott végponton; várjon Retry-After másodpercet.

Egy érvényesítési hiba:

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

Monitorok

A monitor egy ellenőrzés: weboldal, SSL-tanúsítvány, ping, TCP-port, DNS-rekord, cron heartbeat vagy egy domain levelezési beállításai. Típusok: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. A GET /check-types megmondja, hogy a csomagja mely típusokat, intervallumokat és helyszíneket tartalmazza, és megadja minden típus alapértékeit.

VégpontMit csinál
GET /monitors Lista; szűrők: status, search, ids (vesszővel elválasztva), with_stats=1 hozzáadja az uptime-ot és az utolsó válaszidőt
POST /monitors Létrehozás; az ellenőrzések a háttérben indulnak
GET /monitors/{id} Egy monitor helyszíneivel és a nyitott incidenssel
PATCH /monitors/{id} Módosítás; a típus nem változtatható
DELETE /monitors/{id} Törlés (204)
POST /monitors/{id}/pause Szüneteltetés; a nyitott incidens lezárul
POST /monitors/{id}/resume Folytatás
GET /check-types Típusok, alapértékek és a csomag korlátai
GET /locations Aktív ellenőrzési helyszínek (code, name, country)

Mezők létrehozáskor

MezőLeírás
name Megjelenített név, legfeljebb 255 karakter. Kötelező.
type A fenti típusok egyike. Kötelező, utólag nem módosítható.
target URL, hosztnév, IP-cím vagy domain, a típustól függően. Kötelező, kivéve a heartbeat esetén, amely helyette ping URL-t ad.
interval_seconds Ellenőrzési intervallum. A minimum a csomagtól függ; a GET /check-types limits.min_interval_seconds néven adja vissza.
locations Helyszínkódok, például ["eu", "sg"]. Hányat választhat, az a csomagtól függ.
primary_location Fő helyszín, amely elsőként erősíti meg a kieséseket (Smart Verify).
confirm_locations Hány helyszínnek kell látnia a hibát, mielőtt riasztást kap (1–3). Nagyobb csomagokban beállítható.
confirm_checks Hány egymás utáni sikertelen ellenőrzés erősít meg egy kiesést (1–3). Nagyobb csomagokban beállítható.
options Típusonként. http esetén: method (GET, HEAD, POST), expected_status (pl. 200-399 vagy 200,301), keyword a keyword_mode értékkel (present vagy absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. A kihagyott opciók a GET /check-types alapértékeit veszik fel.

Weboldal-ellenőrzés létrehozása kulcsszóval:

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

A válasz (201) a monitor. A provisioning.state synced lesz, amint a helyszínek átvették, a status az első ellenőrzés után pending-ről up-ra vált:

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

Státuszértékek: pending, up, degraded, down, paused.

Szüneteltessen egy monitort a telepítés idejére, majd folytassa:

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 és válaszidők

Az uptime a kiesésekből (major súlyosságú incidensekből) számolódik; a figyelmeztetések, például egy lejáró tanúsítvány, nem számítanak. Ha még nem volt ellenőrzés, az érték null, nem 100.

VégpontMit csinál
GET /monitors/{id}/uptime Uptime százalékban az elmúlt 24 órára, 7 napra és 30 napra
GET /monitors/{id}/daily-uptime Uptime naptári naponként (UTC), days 1–90, alapértelmezés 30
GET /monitors/{id}/response-times Válaszidő és elérhetőség helyszínenként, range 24h, 7d vagy 30d; óránkénti pontok, 30d esetén naponta

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

Válaszidők (rövidítve):

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

Szerverek

A szerver egy ügynökkel ellátott gép, amely jelenti a CPU-t, a memóriát, a terhelést, a lemezeket, a hálózatot és a szolgáltatásokat. A szerver létrehozása egyszer használható telepítési parancsot ad vissza; futtassa a gépen, és a szerver rövidesen megjelenik.

VégpontMit csinál
GET /servers Lista; ids szűrő
POST /servers Létrehozás; a válasz tartalmazza az install_command (Linux) és az install_command_freebsd értéket
GET /servers/{id} Egy szerver leltárral, legutóbbi pillanatképpel és küszöbértékekkel
PATCH /servers/{id} Átnevezés, a figyelt services kiválasztása, a thresholds beállítása
DELETE /servers/{id} Törlés (204); az ügynök kikerül a monitorozásból
POST /servers/{id}/pause Szüneteltetés; a nyitott incidensek lezárulnak
POST /servers/{id}/resume Folytatás
POST /servers/{id}/install-token Új telepítési parancs; a rotate_key=true új ügynökkulcsot is kiad
GET /servers/{id}/metrics Grafikonsorozatok, range 24h, 7d vagy 30d: metrika → kontextus → [unix time, avg, min, max]
MezőLeírás
name Megjelenített név, legfeljebb 100 karakter. Létrehozáskor kötelező.
services A szolgáltatások nevei, amelyeket az ügynöknek figyelnie kell, például ["nginx", "php8.4-fpm", "mariadb"]; legfeljebb 200. A szerver a talált szolgáltatásokat a discovered.services alatt jelenti.
thresholds Riasztási küszöbök: cpu_max (százalék), load_max_per_cpu, mem_min_pavail (szabad százalék), fs_warn és fs_crit (használt százalék), inode_warn, agent_nodata_minutes, csatolási pontonként a filesystems alatt, valamint a reguláris kifejezések: fs_types, fs_exclude, net_exclude. A kihagyott értékek megtartják az alapértelmezést.

Szerver hozzáadása, és a telepítési parancs kiolvasása a válaszból:

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

Három szolgáltatás figyelése és riasztás 80 százalékos lemezhasználatnál:

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

Incidensek

Az incidens egy monitor vagy szerver egyetlen kiesése vagy figyelmeztetése a started_at időponttól a resolved_at időpontig. Minden incidens viseli a riasztási számát, ugyanazt, amelyet a riasztási e-mail mutat.

VégpontMit csinál
GET /incidents Legújabb elöl; szűrők: monitor_id, status (open vagy closed), open=1 (nyitott kiesések közlemények nélkül), from és to (dátumok)
GET /incidents/{id} Egy incidens idővonallal: melyik helyszín mikor esett ki és állt helyre, valamint a javítás, amely kezelte

Nyitott incidensek:

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

Hasznos mezők: subject_type (monitor vagy server), severity (major, warning, info), cause (például unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations, nyitott incidensnél pedig a failure_reason a legutóbbi ellenőrzési értékekkel.

Státuszoldalak

A státuszoldal a kiválasztott monitorokat mutatja a nyilvánosságnak vagy a csapatnak, a mi domainünk alatt vagy a sajátján. A közlemények karbantartást jelentenek be, vagy egy folyamatban lévő incidenst magyaráznak.

VégpontMit csinál
GET /status-pages Lista
POST /status-pages Létrehozás
GET /status-pages/{id} Egy oldal monitorokkal, közleményekkel és a domainjei állapotával
PATCH /status-pages/{id} Módosítás; a monitors az egész listát lecseréli
DELETE /status-pages/{id} Törlés (204)
POST /status-pages/{id}/notices Közlemény hozzáadása
PUT /status-pages/{id}/notices/{notice} Közlemény módosítása
DELETE /status-pages/{id}/notices/{notice} Közlemény eltávolítása (204)
MezőLeírás
slug A cím része, 3–63 karakter, kisbetűk, számjegyek és kötőjelek; egyedi. Kötelező.
title Az oldal címe. Kötelező.
description Rövid szöveg a cím alatt, legfeljebb 2000 karakter.
logo_url Egy logó HTTPS-címe.
custom_domain Saját domain, például status.example.com; saját státuszdomaint tartalmazó csomag kell hozzá.
is_public Nyilvános (true), vagy csak bejelentkezett felhasználóknak.
monitors Rendezett lista: {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; a display_name és a group opcionális.

A közleménynek van kind (maintenance, info vagy incident), title, body (opcionális, legfeljebb 5000 karakter), starts_at és opcionális ends_at mezője.

Nyilvános státuszoldal létrehozása két monitorral:

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

Karbantartási ablak bejelentése:

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

Értesítési csatornák

Az értesítési csatorna egy mód arra, hogy elérjünk valakit: e-mail-cím, Telegram-csevegés, webhook vagy egy felhasználó push eszközei. A csatorna a workspace összes monitorának riasztásait kapja, vagy csak a monitor_ids alatti monitorokét. Hogy a csomagja mely csatornatípusokat tartalmazza, azt a GET /notification-channel-types mutatja.

VégpontMit csinál
GET /notification-channels Lista
POST /notification-channels Létrehozás; webhooknál az aláíró secret csak ebben a válaszban szerepel
GET /notification-channels/{id} Egy csatorna
PATCH /notification-channels/{id} Módosítás; a típus nem változtatható
DELETE /notification-channels/{id} Törlés (204)
POST /notification-channels/{id}/test Tesztértesítés küldése (202); a meg nem erősített e-mail-cím helyette újra megkapja a megerősítő linkjét
GET /notification-channel-types Csatornatípusok available és paid jelzéssel
MezőLeírás
type email, telegram, webhook vagy push. Kötelező, utólag nem módosítható.
name Megjelenített név. Kötelező.
config Típusonként: {"email": "…"}, {"chat_id": "…"} vagy {"url": "https://…"}. A push nem igényel konfigurációt. Az új e-mail-címet linkkel meg kell erősíteni, mielőtt riasztás megy ki.
monitor_ids Azon monitorok UUID-i, amelyekhez a csatorna tartozik; az összes monitorhoz hagyja el.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: ebben az időablakban nincs riasztás.
escalation_delay_minutes Ezt a csatornát csak akkor riasztja, ha a kiesés ennyi ideig tart (0–1440).
notify_recovery A helyreállásról is küld értesítést (true vagy false).
is_active A csatorna be- vagy kikapcsolása törlés nélkül.

Webhook csatorna létrehozása két monitorhoz, és a secret megőrzése:

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

Webhook payload

A webhook csatorna minden riasztást JSON-ként POST-ol az Ön URL-jére, 10 másodperces időkorláttal és átirányítások nélkül. A célnak nyilvános címnek kell lennie.

Fejlécek: X-Webhook-Timestamp (Unix time), X-Webhook-Signature (sha256= és utána a <timestamp>.<body> HMAC-SHA256 értéke a csatorna secretjével mint kulccsal) és User-Agent: Uptime-Webhook/1.

Az event értéke down, recovered, paused vagy test. Monitorriasztásnál a törzs tartalmazza a monitor (id, name, target) és az incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations) mezőt; szerverriasztásnál a server (id, name) és az incident mezőt, a helyszínek helyett problem értékkel. A subject a riasztás címsora a csatorna nyelvén.

Egy down riasztás törzse:

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

Az aláírást ellenőrizze, mielőtt megbízik a törzsben: számolja ki a HMAC-ot a nyers törzsön pontosan úgy, ahogy megérkezett, és hasonlítsa össze állandó idő alatt. Utasítsa el a néhány percnél régebbi időbélyegeket.

Az aláírás ellenőrzése shellben:

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

Dashboard összesítő

A GET /dashboard az áttekintő csempék mögötti számokat adja vissza: monitorok státuszonként (a szerverek csomagegységeikkel számítanak), szerverek státuszonként és a nyitott incidensek száma. A monitors:read, servers:read vagy incidents:read bármelyike megnyitja.

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

Gyakran ismételt kérdések

Melyik csomag tartalmazza az API-t?

Az API tokenek a Business csomagtól felfelé érhetők el. A kisebb csomagoknál a Fiókom alatt a szakasz szürkítve látszik, frissítési linkkel. A Centoculus minden egyéb része API nélkül is működik.

Egy token mindent tud, amit a fiókom?

Nem. A token csak azokat a területeket éri el, amelyekhez scope-ot adott, és soha nem a számlázást, a csapattagokat, a többi tokent, a fiókbiztonságot vagy a javításokat. Ezek az alkalmazásban maradnak.

Van sandbox?

Felfedezéshez használjon csak read scope-os tokent, a tesztmonitorokat pedig egy második fiók ingyenes csomagjában hozza létre. A létrehozott monitorok ugyanúgy számítanak a csomagba, mint az alkalmazásban létrehozottak.

Hogyan juttatom a riasztásokat a saját rendszeremhez?

Hozzon létre egy webhook csatornát, és minden kézbesítésnél ellenőrizze az aláírást. Minden kiesés, helyreállás és szüneteltetés másodperceken belül eléri az URL-jét, a monitorral, az okkal és az érintett helyszínekkel JSON-ként.

Változik az API?

A verzió a címben van (/api/v1). A válaszokba bármikor bekerülhetnek új mezők; egy verzión belül mezőket nem távolítunk el és nem nevezünk át. Olvassa ki, amire szüksége van, a többit hagyja figyelmen kívül.

Készen áll a monitorozás automatizálására?

Az API tokenek a Business csomagtól felfelé tartoznak az árba. Hasonlítsa össze a csomagokat, vagy kezdje ingyen, és váltson, ha a szkriptjei készen állnak.