Preskoči na vsebino
Centoculus

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.

  1. Ustvarite žeton pod Moj račun → API-žetoni v spletni ali mobilni aplikaciji in izberite njegove scope-e.
  2. Žeton takoj kopirajte; prikazan je samo enkrat.
  3. 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.

ScopeDovoljuje
monitors:readSeznam in prikaz monitorjev, razpoložljivosti, dnevne razpoložljivosti, odzivnih časov, vrst preverjanj, lokacij, povzetek nadzorne plošče
monitors:writeUstvarjanje, posodabljanje, brisanje, začasna ustavitev in nadaljevanje monitorjev
servers:readSeznam in prikaz strežnikov in njihovih metrik
servers:writeUstvarjanje, posodabljanje, brisanje, začasna ustavitev in nadaljevanje strežnikov; nov ukaz za namestitev agenta
incidents:readSeznam in prikaz incidentov, povzetek nadzorne plošče
status-pages:readSeznam in prikaz strani stanja
status-pages:writeUstvarjanje, posodabljanje in brisanje strani stanja in njihovih obvestil
notifications:readSeznam in prikaz kanalov obvestil in vrst kanalov
notifications:writeUstvarjanje, 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 pod data skupaj z links in meta.
  • 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 page in per_page; meta vsebuje current_page, last_page, per_page in total. 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_id in 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.

StatusPomen
401Žeton manjka, je neveljaven, potekel ali preklican.
402Nadzor 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.
404Ni najdeno ali ni v vašem delovnem prostoru.
409Konflikt, na primer potrjevanje e-poštnega naslova, ki je že potrjen.
422Validacija ni uspela; glejte errors. Ko je dosežena omejitev paketa, upgrade navede funkcijo, ki jo odklene večji paket.
429Preveč 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.

EndpointKaj 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

PoljeOpis
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.

EndpointKaj 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.

EndpointKaj 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]
PoljeOpis
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.

EndpointKaj 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.

EndpointKaj 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)
PoljeOpis
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.

EndpointKaj 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
PoljeOpis
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.