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.
- 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.
- Másolja ki a tokent azonnal; csak egyszer jelenik meg.
- Hívja meg a
GET /mevé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.
| Scope | Engedélyezi |
|---|---|
monitors:read | Monitorok listázása és megtekintése, uptime, napi uptime, válaszidők, ellenőrzéstípusok, helyszínek, dashboard összesítő |
monitors:write | Monitorok létrehozása, módosítása, törlése, szüneteltetése és folytatása |
servers:read | Szerverek és metrikáik listázása és megtekintése |
servers:write | Szerverek 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:read | Incidensek listázása és megtekintése, dashboard összesítő |
status-pages:read | Státuszoldalak listázása és megtekintése |
status-pages:write | Stá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:write | Csatorná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
dataalatt érkezik, a lista adataalattlinksésmetamellett. - 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ésper_pagelekérdezési paraméterekkel történik; ametatartalmazza acurrent_page,last_page,per_pageéstotalé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-Afterfejlé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átusz | Jelentés |
|---|---|
401 | Hiányzó, érvénytelen, lejárt vagy visszavont token. |
402 | A monitorozás szünetel, mert az előre fizetett egyenleg elfogyott (viszonteladói ügyfelek); feltöltés után folytatódik. |
403 | A tokenből hiányzik a scope, a végpont zárt az API tokenek előtt, vagy a csomag nem tartalmazza a funkciót. |
404 | Nem 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. |
422 | Az é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. |
429 | Tú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égpont | Mit 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égpont | Mit 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égpont | Mit 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égpont | Mit 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égpont | Mit 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égpont | Mit 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.