API za nadzor razpoložljivosti
Vse, kar počnete v aplikaciji, lahko počnete tudi prek REST API-ja: ustvarjajte monitorje iz svojega deployment pipeline, črpajte razpoložljivost in odzivne čase v lastne nadzorne plošče, usklajujte strani stanja in kanale opozoril. JSON noter, JSON ven, en žeton Bearer. API-žetoni so del paketa Business in višjih.
Prvi koraki
Osnovni URL
https://app.centoculus.com/api/v1
Vsaka zahteva nosi dve glavi: Authorization: Bearer <token> in Accept: application/json. Zahteve z vsebino pošiljajo JSON z Content-Type: application/json.
- Ustvarite žeton pod Moj račun → API-žetoni v spletni ali mobilni aplikaciji in izberite njegove scope-e.
- Žeton takoj kopirajte; prikazan je samo enkrat.
- Pokličite
GET /me. Deluje z vsakim žetonom in pove, čigav je žeton.
Vaš prvi klic:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
Odgovor je vaš uporabnik z vlogo, jezikom in delovnimi prostori, do katerih žeton sega (skrajšano):
{
"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
}
}
Žetoni in scopei
Žeton ima ime, neobvezen potek veljavnosti (do 730 dni) in scope-e, ki jih sme uporabljati. Izberite le tiste, ki jih integracija potrebuje: nadzorna plošča dobi monitors:read in incidents:read, deployment skripta dobi monitors:write. V paketih pod Business je razdelek viden, vendar zatemnjen.
| Scope | Dovoljuje |
|---|---|
monitors:read | Seznam in prikaz monitorjev, razpoložljivosti, dnevne razpoložljivosti, odzivnih časov, vrst preverjanj, lokacij, povzetek nadzorne plošče |
monitors:write | Ustvarjanje, posodabljanje, brisanje, začasna ustavitev in nadaljevanje monitorjev |
servers:read | Seznam in prikaz strežnikov in njihovih metrik |
servers:write | Ustvarjanje, posodabljanje, brisanje, začasna ustavitev in nadaljevanje strežnikov; nov ukaz za namestitev agenta |
incidents:read | Seznam in prikaz incidentov, povzetek nadzorne plošče |
status-pages:read | Seznam in prikaz strani stanja |
status-pages:write | Ustvarjanje, posodabljanje in brisanje strani stanja in njihovih obvestil |
notifications:read | Seznam in prikaz kanalov obvestil in vrst kanalov |
notifications:write | Ustvarjanje, posodabljanje in brisanje kanalov (e-pošta, Telegram, webhook, push), pošiljanje testa |
GET /me deluje z vsakim žetonom. Obračun, ekipa, žetoni, varnost računa in popravila z API-žetonom niso dosegljivi in odgovorijo s 403, enako velja za klic brez ustreznega scope-a.
Žeton prekličite na istem mestu; takoj preneha delovati.
Konvencije
- Odgovori so JSON. Posamezen objekt pride pod
data, seznam poddataskupaj zlinksinmeta. - Monitorji in strežniki se naslavljajo z UUID; incidenti, strani stanja in kanali obvestil s številčnim id.
- Časi so v formatu ISO 8601 v UTC, na primer
2026-11-15T08:30:00.000000Z. - Seznami so razdeljeni na strani s parametroma poizvedbe
pageinper_page;metavsebujecurrent_page,last_page,per_pageintotal. Privzete velikosti strani: monitorji 15 (največ 200), incidenti 25 (največ 100), kanali obvestil 50, strežniki 100, strani stanja 15. - Računi z več delovnimi prostori (partnerji in preprodajalci) ob ustvarjanju posredujejo
customer_idin z njim lahko filtrirajo sezname. Računi strank ga izpustijo. - Splošne kvote zahtev ni. Nekaj endpointov je omejenih, na primer ponovno pošiljanje potrditve e-pošte (10 na minuto); odgovorijo s 429 in
Retry-After. Ne poizvedujte pogosteje, kot je vaš interval preverjanja; za podatke v živo uporabite webhook kanal.
Napake
Napake so JSON s poljem message. Napake validacije dodajo errors s seznamom sporočil za vsako polje.
| Status | Pomen |
|---|---|
401 | Žeton manjka, je neveljaven, potekel ali preklican. |
402 | Nadzor je začasno ustavljen, ker je predplačniško stanje porabljeno (stranke preprodajalcev); nadaljuje se po dopolnitvi. |
403 | Žetonu manjka scope, endpoint je za API-žetone zaprt ali vaš paket funkcije ne vključuje. |
404 | Ni najdeno ali ni v vašem delovnem prostoru. |
409 | Konflikt, na primer potrjevanje e-poštnega naslova, ki je že potrjen. |
422 | Validacija ni uspela; glejte errors. Ko je dosežena omejitev paketa, upgrade navede funkcijo, ki jo odklene večji paket. |
429 | Preveč zahtev na omejenem endpointu; počakajte Retry-After sekund. |
Napaka validacije:
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."]
}
}
Monitorji
Monitor je eno preverjanje: spletno mesto, SSL-certifikat, ping, vrata TCP, zapis DNS, cron heartbeat ali nastavitve e-pošte domene. Vrste: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types pove, katere vrste, intervale in lokacije vaš paket vključuje, in privzete vrednosti vsake vrste.
| Endpoint | Kaj naredi |
|---|---|
GET /monitors |
Seznam; filtri status, search, ids (ločeni z vejico), with_stats=1 doda razpoložljivost in zadnji odzivni čas |
POST /monitors |
Ustvari; preverjanja se začnejo v ozadju |
GET /monitors/{id} |
En monitor z lokacijami in odprtim incidentom |
PATCH /monitors/{id} |
Posodobi; vrste ni mogoče spremeniti |
DELETE /monitors/{id} |
Izbriše (204) |
POST /monitors/{id}/pause |
Začasno ustavi; odprti incident se zapre |
POST /monitors/{id}/resume |
Nadaljuje |
GET /check-types |
Vrste, privzete vrednosti in omejitve vašega paketa |
GET /locations |
Aktivne lokacije preverjanja (code, name, country) |
Polja pri ustvarjanju
| Polje | Opis |
|---|---|
name |
Prikazano ime, do 255 znakov. Obvezno. |
type |
Ena od zgoraj navedenih vrst. Obvezno, pozneje nespremenljivo. |
target |
URL, ime gostitelja, naslov IP ali domena, odvisno od vrste. Obvezno razen za heartbeat, ki namesto tega dobi ping URL. |
interval_seconds |
Interval preverjanja. Najmanjša vrednost je odvisna od vašega paketa; GET /check-types jo vrne kot limits.min_interval_seconds. |
locations |
Kode lokacij, na primer ["eu", "sg"]. Koliko jih smete izbrati, je odvisno od vašega paketa. |
primary_location |
Glavna lokacija, ki izpade potrdi prva (Smart Verify). |
confirm_locations |
Koliko lokacij mora videti napako, preden dobite opozorilo (1–3). Nastavljivo v višjih paketih. |
confirm_checks |
Koliko zaporednih neuspelih preverjanj potrdi izpad (1–3). Nastavljivo v višjih paketih. |
options |
Glede na vrsto. Za http: method (GET, HEAD, POST), expected_status (npr. 200-399 ali 200,301), keyword s keyword_mode (present ali absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Izpuščene možnosti prevzamejo privzete vrednosti iz GET /check-types. |
Ustvarjanje preverjanja spletnega mesta s ključno besedo:
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"}
}'
Odgovor (201) je monitor. provisioning.state preide v synced, ko lokacije monitor prevzamejo, status iz pending v up po prvem preverjanju:
{
"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"
}
}
Vrednosti statusa: pending, up, degraded, down, paused.
Monitor med deploymentom začasno ustavite in ga nato nadaljujte:
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"
Razpoložljivost in odzivni časi
Razpoložljivost se izračuna iz izpadov (incidenti resnosti major); opozorila, kot je potekajoč certifikat, se ne štejejo. Še ni preverjeno pomeni null, ne 100.
| Endpoint | Kaj naredi |
|---|---|
GET /monitors/{id}/uptime |
Razpoložljivost v odstotkih za zadnjih 24 ur, 7 dni in 30 dni |
GET /monitors/{id}/daily-uptime |
Razpoložljivost po koledarskem dnevu (UTC), days 1–90, privzeto 30 |
GET /monitors/{id}/response-times |
Odzivni čas in razpoložljivost po lokaciji, range 24h, 7d ali 30d; urne točke, za 30d dnevne |
Razpoložljivost:
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}}
Odzivni časi (skrajšano):
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}
]
}
}
}
Strežniki
Strežnik je računalnik z agentom, ki poroča o CPE, pomnilniku, obremenitvi, diskih, omrežju in storitvah. Ustvarjanje strežnika vrne enkraten ukaz za namestitev; zaženite ga na računalniku in strežnik se čez trenutek pojavi.
| Endpoint | Kaj naredi |
|---|---|
GET /servers |
Seznam; filter ids |
POST /servers |
Ustvari; odgovor vsebuje install_command (Linux) in install_command_freebsd |
GET /servers/{id} |
En strežnik z inventarjem, zadnjim posnetkom in pragovi |
PATCH /servers/{id} |
Preimenuje, izbere nadzorovane services, nastavi thresholds |
DELETE /servers/{id} |
Izbriše (204); agent je odstranjen iz nadzora |
POST /servers/{id}/pause |
Začasno ustavi; odprti incidenti se zaprejo |
POST /servers/{id}/resume |
Nadaljuje |
POST /servers/{id}/install-token |
Nov ukaz za namestitev; rotate_key=true izda tudi nov ključ agenta |
GET /servers/{id}/metrics |
Serije za grafikone, range 24h, 7d ali 30d: metrika → kontekst → [unix time, avg, min, max] |
| Polje | Opis |
|---|---|
name |
Prikazano ime, do 100 znakov. Obvezno pri ustvarjanju. |
services |
Imena storitev, ki naj jih agent nadzoruje, na primer ["nginx", "php8.4-fpm", "mariadb"]; do 200. Strežnik poroča, kaj je našel, pod discovered.services. |
thresholds |
Pragovi opozoril: cpu_max (odstotek), load_max_per_cpu, mem_min_pavail (odstotek prostega), fs_warn in fs_crit (odstotek zasedenega), inode_warn, agent_nodata_minutes, po priklopni točki pod filesystems ter regularni izrazi fs_types, fs_exclude, net_exclude. Izpuščene vrednosti obdržijo privzete. |
Dodajte strežnik in iz odgovora preberite ukaz za namestitev:
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"
}
}
Nadzirajte tri storitve in opozorite pri 80 odstotkih zasedenosti diska:
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}
}'
Incidenti
Incident je en izpad ali opozorilo monitorja ali strežnika, od started_at do resolved_at. Vsak incident nosi svojo številko opozorila, enako kot jo prikazuje e-pošta z opozorilom.
| Endpoint | Kaj naredi |
|---|---|
GET /incidents |
Najnovejši prvi; filtri monitor_id, status (open ali closed), open=1 (odprti izpadi brez obvestil), from in to (datuma) |
GET /incidents/{id} |
En incident z časovnico: kdaj je katera lokacija odpovedala in si opomogla ter popravilo, ki ga je rešilo |
Odprti incidenti:
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}
}
Uporabna polja: subject_type (monitor ali server), severity (major, warning, info), cause (na primer unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations in, dokler je odprt, failure_reason z zadnjimi vrednostmi preverjanja.
Strani stanja
Stran stanja prikaže izbrane monitorje javnosti ali vaši ekipi, na naši domeni ali vaši. Obvestila napovedujejo vzdrževanje ali pojasnjujejo incident, ki še traja.
| Endpoint | Kaj naredi |
|---|---|
GET /status-pages |
Seznam |
POST /status-pages |
Ustvari |
GET /status-pages/{id} |
Ena stran z monitorji, obvestili in stanjem njenih domen |
PATCH /status-pages/{id} |
Posodobi; monitors nadomesti celoten seznam |
DELETE /status-pages/{id} |
Izbriše (204) |
POST /status-pages/{id}/notices |
Doda obvestilo |
PUT /status-pages/{id}/notices/{notice} |
Posodobi obvestilo |
DELETE /status-pages/{id}/notices/{notice} |
Odstrani obvestilo (204) |
| Polje | Opis |
|---|---|
slug |
Del naslova, 3–63 znakov, male črke, števke in vezaji; enolično. Obvezno. |
title |
Naslov strani. Obvezno. |
description |
Kratko besedilo pod naslovom, do 2000 znakov. |
logo_url |
Naslov HTTPS logotipa. |
custom_domain |
Lastna domena, kot je status.example.com; zahteva paket z lastnimi domenami strani stanja. |
is_public |
Javno (true) ali samo za prijavljene uporabnike. |
monitors |
Urejen seznam {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name in group sta neobvezna. |
Obvestilo ima kind (maintenance, info ali incident), title, body (neobvezno, do 5000 znakov), starts_at in neobvezen ends_at.
Ustvarjanje javne strani stanja z dvema monitorjema:
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"}
]
}'
Napoved okna vzdrževanja:
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"
}'
Kanali obvestil
Kanal obvestil je en način, da nekoga dosežete: e-poštni naslov, klepet Telegram, webhook ali push naprave uporabnika. Kanal prejema opozorila vseh monitorjev delovnega prostora ali samo monitorjev v monitor_ids. Katere vrste kanalov vaš paket vključuje: GET /notification-channel-types.
| Endpoint | Kaj naredi |
|---|---|
GET /notification-channels |
Seznam |
POST /notification-channels |
Ustvari; pri webhooku je podpisni secret samo v tem odgovoru |
GET /notification-channels/{id} |
En kanal |
PATCH /notification-channels/{id} |
Posodobi; vrste ni mogoče spremeniti |
DELETE /notification-channels/{id} |
Izbriše (204) |
POST /notification-channels/{id}/test |
Pošlje testno obvestilo (202); nepotrjen e-poštni naslov namesto tega ponovno dobi potrditveno povezavo |
GET /notification-channel-types |
Vrste kanalov z available in paid |
| Polje | Opis |
|---|---|
type |
email, telegram, webhook ali push. Obvezno, pozneje nespremenljivo. |
name |
Prikazano ime. Obvezno. |
config |
Glede na vrsto: {"email": "…"}, {"chat_id": "…"} ali {"url": "https://…"}. Push config ne potrebuje. Nov e-poštni naslov je treba pred pošiljanjem opozoril potrditi s povezavo. |
monitor_ids |
UUID-ji monitorjev, za katere je kanal namenjen; izpustite za vse monitorje. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: v tem oknu brez opozoril. |
escalation_delay_minutes |
Ta kanal opozori šele, ko izpad traja toliko časa (0–1440). |
notify_recovery |
Pošlje tudi sporočilo o odpravi težave (true ali false). |
is_active |
Vklop ali izklop kanala brez brisanja. |
Ustvarjanje webhook kanala za dva monitorja in shranjevanje secreta:
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
Webhook kanal z metodo POST pošlje vsako opozorilo kot JSON na vaš URL, s časovno omejitvijo 10 sekund in brez preusmeritev. Cilj mora biti javni naslov.
Glave: X-Webhook-Timestamp (Unix čas), X-Webhook-Signature (sha256=, ki mu sledi HMAC-SHA256 od <timestamp>.<body> s secretom kanala kot ključem) in User-Agent: Uptime-Webhook/1.
event je down, recovered, paused ali test. Pri opozorilu monitorja vsebina nosi monitor (id, name, target) in incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); pri opozorilu strežnika server (id, name) in incident s problem namesto lokacij. subject je naslov opozorila v jeziku kanala.
Vsebina opozorila o izpadu:
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 preverite, preden zaupate vsebini: izračunajte HMAC nad surovo vsebino natanko tako, kot je bila prejeta, in ga primerjajte v konstantnem času. Zavrnite časovne žige, starejše od nekaj minut.
Preverjanje podpisa v lupini:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Povzetek nadzorne plošče
GET /dashboard vrne števila za ploščicami pregleda: monitorji po statusu (strežniki se štejejo s svojimi enotami paketa), strežniki po statusu in število odprtih incidentov. Odpre ga katerikoli od monitors:read, servers:read ali 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
}
}
Pogosta vprašanja
Kateri paket vključuje API?
API-žetoni so del paketa Business in višjih. V manjših paketih razdelek vidite pod Moj račun, zatemnjen s povezavo za nadgradnjo. Vse drugo v Centoculusu deluje brez API-ja.
Ali lahko en žeton naredi vse, kar lahko moj račun?
Ne. Žeton doseže le področja, za katera ste mu dali scope-e, nikoli pa obračuna, članov ekipe, drugih žetonov, varnosti računa ali popravil. Ti ostanejo v aplikaciji.
Ali obstaja peskovnik?
Za raziskovanje uporabite žeton samo z bralnimi scope-i, testne monitorje pa ustvarjajte v brezplačnem paketu drugega računa. Monitorji, ki jih ustvarite, se štejejo v vaš paket enako kot tisti, narejeni v aplikaciji.
Kako opozorila dobim v lasten sistem?
Ustvarite webhook kanal in preverjajte podpis vsake dostave. Vsak izpad, okrevanje in začasna ustavitev pride na vaš URL v nekaj sekundah, z monitorjem, vzrokom in prizadetimi lokacijami kot JSON.
Ali se API spreminja?
Različica je v naslovu (/api/v1). Odgovorom se lahko kadar koli dodajo nova polja; polja se znotraj različice ne odstranjujejo ali preimenujejo. Preberite, kar potrebujete, preostalo prezrite.
Ste pripravljeni avtomatizirati nadzor?
API-žetoni so vključeni v paket Business in višje. Primerjajte pakete ali začnite brezplačno in nadgradite, ko bodo skripte pripravljene.