Preskoči na sadržaj
Centoculus

API za nadzor dostupnosti

Sve što radite u aplikaciji možete raditi i preko REST API-ja: stvarajte monitore iz svog deployment pipelinea, povlačite dostupnost i vrijeme odgovora u vlastite nadzorne ploče, održavajte statusne stranice i kanale upozorenja usklađenima. JSON na ulazu, JSON na izlazu, jedan Bearer token. API tokeni dolaze s planom Business i višima.

Prvi koraci

Osnovni URL

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

Svaki zahtjev nosi dva zaglavlja: Authorization: Bearer <token> i Accept: application/json. Zahtjevi s tijelom šalju JSON uz Content-Type: application/json.

  1. Stvorite token u Moj račun → API tokeni u web-aplikaciji ili mobilnoj aplikaciji i odaberite njegove scopeove.
  2. Odmah kopirajte token; prikazuje se samo jednom.
  3. Pozovite GET /me. Radi sa svakim tokenom i govori vam kome token pripada.

Vaš prvi poziv:

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

Odgovor je vaš korisnik s ulogom, jezikom i radnim prostorima do kojih token seže (skraćeno):

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

Tokeni i scopeovi

Token ima naziv, neobavezan rok isteka (do 730 dana) i scopeove koje smije koristiti. Odaberite samo one koje integracija treba: nadzorna ploča dobiva monitors:read i incidents:read, deployment skripta dobiva monitors:write. Na planovima ispod Businessa odjeljak je vidljiv, ali zasivljen.

ScopeDopušta
monitors:readPopis i prikaz monitora, dostupnosti, dnevne dostupnosti, vremena odgovora, vrsta provjera, lokacija, sažetak nadzorne ploče
monitors:writeStvaranje, izmjena, brisanje, pauziranje i nastavak monitora
servers:readPopis i prikaz servera i njihovih metrika
servers:writeStvaranje, izmjena, brisanje, pauziranje i nastavak servera; nova naredba za instalaciju agenta
incidents:readPopis i prikaz incidenata, sažetak nadzorne ploče
status-pages:readPopis i prikaz statusnih stranica
status-pages:writeStvaranje, izmjena i brisanje statusnih stranica i njihovih obavijesti
notifications:readPopis i prikaz kanala obavijesti i vrsta kanala
notifications:writeStvaranje, izmjena i brisanje kanala (e-pošta, Telegram, webhook, push), slanje testa

GET /me radi sa svakim tokenom. Naplata, tim, tokeni, sigurnost računa i popravci nisu dostupni s API tokenom i odgovaraju s 403, kao i poziv bez odgovarajućeg scopea.

Token opozovite na istom mjestu; prestaje raditi odmah.

Konvencije

  • Odgovori su JSON. Pojedinačni objekt dolazi pod data, popis pod data zajedno s links i meta.
  • Monitori i serveri adresiraju se pomoću UUID-a; incidenti, statusne stranice i kanali obavijesti numeričkim id-om.
  • Vremena su u ISO 8601 formatu u UTC-u, na primjer 2026-11-15T08:30:00.000000Z.
  • Popisi su podijeljeni na stranice parametrima upita page i per_page; meta sadrži current_page, last_page, per_page i total. Zadane veličine stranice: monitori 15 (maks. 200), incidenti 25 (maks. 100), kanali obavijesti 50, serveri 100, statusne stranice 15.
  • Računi s više radnih prostora (partneri i preprodavači) pri stvaranju šalju customer_id i njime mogu filtrirati popise. Korisnički računi ga izostavljaju.
  • Nema općenite kvote zahtjeva. Nekoliko endpointa je ograničeno, na primjer ponovno slanje potvrde e-pošte (10 u minuti); oni odgovaraju s 429 i Retry-After. Ne upitkujte češće od intervala provjere; za podatke uživo koristite webhook kanal.

Pogreške

Pogreške su JSON s poljem message. Pogreške validacije dodaju errors s jednim popisom poruka po polju.

StatusZnačenje
401Token nedostaje, nevažeći je, istekao ili opozvan.
402Nadzor je pauziran jer je prepaid stanje potrošeno (korisnici preprodavača); nastavlja se nakon uplate.
403Tokenu nedostaje scope, endpoint je zatvoren za API tokene ili vaš plan ne uključuje tu funkciju.
404Nije pronađeno ili nije u vašem radnom prostoru.
409Sukob, na primjer potvrda adrese e-pošte koja je već potvrđena.
422Validacija nije uspjela; pogledajte errors. Kad se dosegne ograničenje plana, upgrade navodi funkciju koju otključava veći plan.
429Previše zahtjeva na ograničenom endpointu; pričekajte Retry-After sekundi.

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

Monitori

Monitor je jedna provjera: web-mjesto, SSL certifikat, ping, TCP port, DNS zapis, cron heartbeat ili postavke e-pošte domene. Vrste: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types kaže koje vrste, intervale i lokacije vaš plan uključuje te zadane vrijednosti svake vrste.

EndpointŠto radi
GET /monitors Popis; filteri status, search, ids (odvojeni zarezom), with_stats=1 dodaje dostupnost i zadnje vrijeme odgovora
POST /monitors Stvaranje; provjere počinju u pozadini
GET /monitors/{id} Jedan monitor s lokacijama i otvorenim incidentom
PATCH /monitors/{id} Izmjena; vrsta se ne može promijeniti
DELETE /monitors/{id} Brisanje (204)
POST /monitors/{id}/pause Pauziranje; otvoreni incident se zatvara
POST /monitors/{id}/resume Nastavak
GET /check-types Vrste, zadane vrijednosti i ograničenja vašeg plana
GET /locations Aktivne lokacije provjere (code, name, country)

Polja pri stvaranju

PoljeOpis
name Prikazani naziv, do 255 znakova. Obavezno.
type Jedna od gore navedenih vrsta. Obavezno, poslije se ne mijenja.
target URL, naziv hosta, IP adresa ili domena, ovisno o vrsti. Obavezno osim za heartbeat, koji umjesto toga dobiva ping URL.
interval_seconds Interval provjere. Minimum ovisi o vašem planu; GET /check-types vraća ga kao limits.min_interval_seconds.
locations Kodovi lokacija, na primjer ["eu", "sg"]. Koliko ih smijete odabrati ovisi o vašem planu.
primary_location Glavna lokacija koja prva potvrđuje ispade (Smart Verify).
confirm_locations Koliko lokacija mora vidjeti kvar prije nego što dobijete upozorenje (1–3). Podesivo na većim planovima.
confirm_checks Koliko uzastopnih neuspjelih provjera potvrđuje ispad (1–3). Podesivo na većim planovima.
options Ovisno o vrsti. Za http: method (GET, HEAD, POST), expected_status (npr. 200-399 ili 200,301), keyword s keyword_mode (present ili absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Izostavljene opcije preuzimaju zadane vrijednosti iz GET /check-types.

Stvaranje provjere web-mjesta s ključnom riječi:

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 prelazi u synced čim lokacije preuzmu monitor, status iz pending u up nakon prve provjere:

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

Vrijednosti statusa: pending, up, degraded, down, paused.

Pauzirajte monitor tijekom deploymenta i nastavite ga poslije:

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"

Dostupnost i vrijeme odgovora

Dostupnost se računa iz ispada (incidenti ozbiljnosti major); upozorenja poput certifikata koji uskoro ističe ne ulaze u izračun. Još neprovjereno znači null, a ne 100.

EndpointŠto radi
GET /monitors/{id}/uptime Dostupnost u postocima za zadnja 24 sata, 7 dana i 30 dana
GET /monitors/{id}/daily-uptime Dostupnost po kalendarskom danu (UTC), days 1–90, zadano 30
GET /monitors/{id}/response-times Vrijeme odgovora i dostupnost po lokaciji, range 24h, 7d ili 30d; satne točke, za 30d dnevne

Dostupnost:

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

Vremena odgovora (skraćeno):

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

Serveri

Server je stroj s agentom koji izvještava o CPU-u, memoriji, opterećenju, diskovima, mreži i servisima. Stvaranje servera vraća jednokratnu naredbu za instalaciju; pokrenite je na stroju i server se pojavljuje trenutak poslije.

EndpointŠto radi
GET /servers Popis; filter ids
POST /servers Stvaranje; odgovor sadrži install_command (Linux) i install_command_freebsd
GET /servers/{id} Jedan server s inventarom, zadnjim snimkom i pragovima
PATCH /servers/{id} Preimenovanje, odabir nadziranih services, postavljanje thresholds
DELETE /servers/{id} Brisanje (204); agent se uklanja iz nadzora
POST /servers/{id}/pause Pauziranje; otvoreni incidenti se zatvaraju
POST /servers/{id}/resume Nastavak
POST /servers/{id}/install-token Nova naredba za instalaciju; rotate_key=true izdaje i novi ključ agenta
GET /servers/{id}/metrics Serije za grafikone, range 24h, 7d ili 30d: metrika → kontekst → [unix time, avg, min, max]
PoljeOpis
name Prikazani naziv, do 100 znakova. Obavezno pri stvaranju.
services Nazivi servisa koje agent treba nadzirati, na primjer ["nginx", "php8.4-fpm", "mariadb"]; do 200. Server izvještava što je pronašao pod discovered.services.
thresholds Pragovi upozorenja: cpu_max (postotak), load_max_per_cpu, mem_min_pavail (postotak slobodno), fs_warn i fs_crit (postotak zauzeto), inode_warn, agent_nodata_minutes, po točki montiranja pod filesystems te regularni izrazi fs_types, fs_exclude, net_exclude. Izostavljene vrijednosti zadržavaju zadane.

Dodajte server i iz odgovora pročitajte naredbu za instalaciju:

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

Nadzirite tri servisa i upozorite kod 80 posto zauzetosti 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 jedan ispad ili upozorenje monitora ili servera, od started_at do resolved_at. Svaki incident nosi svoj broj upozorenja, isti onaj koji prikazuje e-pošta s upozorenjem.

EndpointŠto radi
GET /incidents Najnoviji prvi; filteri monitor_id, status (open ili closed), open=1 (otvoreni ispadi bez obavijesti), from i to (datumi)
GET /incidents/{id} Jedan incident s vremenskom crtom: kada je koja lokacija pala i oporavila se te popravak koji ga je riješio

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

Korisna polja: subject_type (monitor ili server), severity (major, warning, info), cause (na primjer unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations i, dok je otvoren, failure_reason s najnovijim vrijednostima provjere.

Statusne stranice

Statusna stranica prikazuje odabrane monitore javnosti ili vašem timu, na našoj domeni ili vašoj. Obavijesti najavljuju održavanje ili objašnjavaju incident koji traje.

EndpointŠto radi
GET /status-pages Popis
POST /status-pages Stvaranje
GET /status-pages/{id} Jedna stranica s monitorima, obavijestima i stanjem njezinih domena
PATCH /status-pages/{id} Izmjena; monitors zamjenjuje cijeli popis
DELETE /status-pages/{id} Brisanje (204)
POST /status-pages/{id}/notices Dodavanje obavijesti
PUT /status-pages/{id}/notices/{notice} Izmjena obavijesti
DELETE /status-pages/{id}/notices/{notice} Uklanjanje obavijesti (204)
PoljeOpis
slug Dio adrese, 3–63 znaka, mala slova, znamenke i crtice; jedinstveno. Obavezno.
title Naslov stranice. Obavezno.
description Kratak tekst ispod naslova, do 2000 znakova.
logo_url HTTPS adresa logotipa.
custom_domain Vlastita domena poput status.example.com; zahtijeva plan s vlastitim domenama statusnih stranica.
is_public Javno (true) ili samo za prijavljene korisnike.
monitors Poredani popis {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name i group nisu obavezni.

Obavijest ima kind (maintenance, info ili incident), title, body (neobavezno, do 5000 znakova), starts_at i neobavezan ends_at.

Stvaranje javne statusne stranice s dva monitora:

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

Najava prozora održavanja:

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 obavijesti

Kanal obavijesti je jedan način da se do nekoga dopre: adresa e-pošte, Telegram chat, webhook ili push uređaji korisnika. Kanal prima upozorenja svih monitora radnog prostora ili samo monitora iz monitor_ids. Koje vrste kanala vaš plan uključuje: GET /notification-channel-types.

EndpointŠto radi
GET /notification-channels Popis
POST /notification-channels Stvaranje; za webhook se secret za potpisivanje nalazi samo u ovom odgovoru
GET /notification-channels/{id} Jedan kanal
PATCH /notification-channels/{id} Izmjena; vrsta se ne može promijeniti
DELETE /notification-channels/{id} Brisanje (204)
POST /notification-channels/{id}/test Slanje testne obavijesti (202); nepotvrđena adresa e-pošte umjesto toga ponovno dobiva poveznicu za potvrdu
GET /notification-channel-types Vrste kanala s available i paid
PoljeOpis
type email, telegram, webhook ili push. Obavezno, poslije se ne mijenja.
name Prikazani naziv. Obavezno.
config Ovisno o vrsti: {"email": "…"}, {"chat_id": "…"} ili {"url": "https://…"}. Push ne treba config. Nova adresa e-pošte mora se potvrditi poveznicom prije nego što krenu upozorenja.
monitor_ids UUID-ovi monitora za koje je kanal namijenjen; izostavite za sve monitore.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: bez upozorenja u tom razdoblju.
escalation_delay_minutes Upozori ovaj kanal tek kad ispad traje toliko dugo (0–1440).
notify_recovery Šalji i obavijest o oporavku (true ili false).
is_active Uključivanje ili isključivanje kanala bez brisanja.

Stvaranje webhook kanala za dva monitora i spremanje 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 šalje svako upozorenje kao JSON POST-om na vaš URL, s vremenskim ograničenjem od 10 sekundi i bez preusmjeravanja. Odredište mora biti javna adresa.

Zaglavlja: X-Webhook-Timestamp (Unix vrijeme), X-Webhook-Signature (sha256= nakon čega slijedi HMAC-SHA256 od <timestamp>.<body> s secretom kanala kao ključem) i User-Agent: Uptime-Webhook/1.

event je down, recovered, paused ili test. Kod upozorenja monitora tijelo sadrži monitor (id, name, target) i incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); kod upozorenja servera server (id, name) i incident s problem umjesto lokacija. subject je naslov upozorenja na jeziku kanala.

Tijelo upozorenja o ispadu:

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

Provjerite potpis prije nego što vjerujete tijelu: izračunajte HMAC nad sirovim tijelom točno onako kako je primljeno i usporedite ga u konstantnom vremenu. Odbacite vremenske oznake starije od nekoliko minuta.

Provjera potpisa u shellu:

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

Sažetak nadzorne ploče

GET /dashboard vraća brojke iza pločica pregleda: monitori po statusu (serveri se računaju sa svojim jedinicama plana), serveri po statusu i broj otvorenih incidenata. Otvara ga bilo koji od monitors:read, servers:read ili 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
  }
}

Često postavljana pitanja

Koji plan uključuje API?

API tokeni dolaze s planom Business i višima. Na manjim planovima odjeljak vidite pod Moj račun, zasivljen s poveznicom za nadogradnju. Sve ostalo u Centoculusu radi bez API-ja.

Može li jedan token sve što može moj račun?

Ne. Token doseže samo područja za koja ste mu dali scopeove, a nikad naplatu, članove tima, druge tokene, sigurnost računa ni popravke. To ostaje u aplikaciji.

Postoji li sandbox?

Za istraživanje koristite token samo s scopeovima za čitanje, a testne monitore stvarajte na besplatnom planu drugog računa. Monitori koje stvorite ulaze u vaš plan kao i oni napravljeni u aplikaciji.

Kako upozorenja dobiti u vlastiti sustav?

Stvorite webhook kanal i provjeravajte potpis svake isporuke. Svaki ispad, oporavak i pauza stižu na vaš URL unutar nekoliko sekundi, s monitorom, uzrokom i pogođenim lokacijama kao JSON.

Mijenja li se API?

Verzija je u adresi (/api/v1). Odgovorima se u bilo kojem trenutku mogu dodati nova polja; polja se unutar verzije ne uklanjaju niti preimenuju. Čitajte što trebate, ostalo zanemarite.

Spremni automatizirati nadzor?

API tokeni uključeni su u plan Business i više. Usporedite planove ili počnite besplatno i nadogradite kad skripte budu spremne.