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.
- Stvorite token u Moj račun → API tokeni u web-aplikaciji ili mobilnoj aplikaciji i odaberite njegove scopeove.
- Odmah kopirajte token; prikazuje se samo jednom.
- 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.
| Scope | Dopušta |
|---|---|
monitors:read | Popis i prikaz monitora, dostupnosti, dnevne dostupnosti, vremena odgovora, vrsta provjera, lokacija, sažetak nadzorne ploče |
monitors:write | Stvaranje, izmjena, brisanje, pauziranje i nastavak monitora |
servers:read | Popis i prikaz servera i njihovih metrika |
servers:write | Stvaranje, izmjena, brisanje, pauziranje i nastavak servera; nova naredba za instalaciju agenta |
incidents:read | Popis i prikaz incidenata, sažetak nadzorne ploče |
status-pages:read | Popis i prikaz statusnih stranica |
status-pages:write | Stvaranje, izmjena i brisanje statusnih stranica i njihovih obavijesti |
notifications:read | Popis i prikaz kanala obavijesti i vrsta kanala |
notifications:write | Stvaranje, 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 poddatazajedno slinksimeta. - 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
pageiper_page;metasadržicurrent_page,last_page,per_pageitotal. 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_idi 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.
| Status | Značenje |
|---|---|
401 | Token nedostaje, nevažeći je, istekao ili opozvan. |
402 | Nadzor je pauziran jer je prepaid stanje potrošeno (korisnici preprodavača); nastavlja se nakon uplate. |
403 | Tokenu nedostaje scope, endpoint je zatvoren za API tokene ili vaš plan ne uključuje tu funkciju. |
404 | Nije pronađeno ili nije u vašem radnom prostoru. |
409 | Sukob, na primjer potvrda adrese e-pošte koja je već potvrđena. |
422 | Validacija nije uspjela; pogledajte errors. Kad se dosegne ograničenje plana, upgrade navodi funkciju koju otključava veći plan. |
429 | Previš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
| Polje | Opis |
|---|---|
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] |
| Polje | Opis |
|---|---|
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) |
| Polje | Opis |
|---|---|
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 |
| Polje | Opis |
|---|---|
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.