Naar de inhoud
Centoculus

Uptime-monitoring-API

Alles wat je in de app doet, kan ook via de REST-API: monitors aanmaken vanuit je deployment-pipeline, uptime en responstijden in je eigen dashboards halen, status pages en meldingskanalen synchroon houden. JSON erin, JSON eruit, één Bearer-token. API-tokens zijn beschikbaar vanaf het Business-abonnement.

Aan de slag

Basis-URL

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

Elk verzoek bevat twee headers: Authorization: Bearer <token> en Accept: application/json. Verzoeken met een body sturen JSON met Content-Type: application/json.

  1. Maak onder Mijn account → API-tokens in de web-app of de telefoon-app een token aan en kies de scopes.
  2. Kopieer het token meteen; het wordt maar één keer getoond.
  3. Roep GET /me aan. Dat werkt met elk token en laat zien van wie het token is.

Je eerste aanroep:

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

Het antwoord is je gebruiker met rol, taal en de werkruimtes die het token bereikt (ingekort):

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

Tokens en scopes

Een token heeft een naam, een optionele vervaldatum (tot 730 dagen) en de scopes die het mag gebruiken. Geef alleen de scopes die een integratie nodig heeft: een dashboard krijgt monitors:read en incidents:read, een deployment-script monitors:write. Bij abonnementen onder Business is het onderdeel zichtbaar maar grijs.

ScopeStaat toe
monitors:readMonitors, uptime, dagelijkse uptime, responstijden, controletypen, locaties en dashboardoverzicht opvragen en tonen
monitors:writeMonitors aanmaken, wijzigen, verwijderen, pauzeren en hervatten
servers:readServers en hun metrics opvragen en tonen
servers:writeServers aanmaken, wijzigen, verwijderen, pauzeren en hervatten; nieuw installatiecommando voor de agent
incidents:readIncidenten en dashboardoverzicht opvragen en tonen
status-pages:readStatus pages opvragen en tonen
status-pages:writeStatus pages en hun mededelingen aanmaken, wijzigen en verwijderen
notifications:readMeldingskanalen en kanaaltypen opvragen en tonen
notifications:writeKanalen (e-mail, Telegram, webhook, push) aanmaken, wijzigen en verwijderen, een test sturen

GET /me werkt met elk token. Facturering, team, tokens, accountbeveiliging en reparaties zijn met een API-token niet bereikbaar en antwoorden met 403, net als een aanroep zonder de juiste scope.

Trek een token op dezelfde plek in; het werkt dan meteen niet meer.

Conventies

  • Antwoorden zijn JSON. Een enkel object komt onder data, een lijst onder data met links en meta.
  • Monitors en servers worden aangesproken via een UUID; incidenten, status pages en meldingskanalen via een numeriek id.
  • Tijden zijn ISO 8601 in UTC, bijvoorbeeld 2026-11-15T08:30:00.000000Z.
  • Lijsten worden gepagineerd met de queryparameters page en per_page; meta bevat current_page, last_page, per_page en total. Standaard paginagrootte: monitors 15 (max. 200), incidenten 25 (max. 100), meldingskanalen 50, servers 100, status pages 15.
  • Accounts met meerdere werkruimtes (partners en resellers) geven bij het aanmaken customer_id mee en kunnen er lijsten mee filteren. Klantaccounts laten het weg.
  • Er is geen algemeen verzoekquotum. Een paar endpoints zijn begrensd, bijvoorbeeld het opnieuw sturen van een e-mailbevestiging (10 per minuut); ze antwoorden met 429 en Retry-After. Vraag niet vaker op dan je controle-interval; gebruik voor live gegevens een webhook-kanaal.

Fouten

Fouten zijn JSON met een message. Validatiefouten voegen errors toe met een lijst meldingen per veld.

StatusBetekenis
401Token ontbreekt, is ongeldig, verlopen of ingetrokken.
402De monitoring is gepauzeerd omdat het prepaidtegoed op is (resellerklanten); na het opwaarderen gaat het verder.
403Het token mist de scope, het endpoint is gesloten voor API-tokens, of je abonnement bevat de functie niet.
404Niet gevonden, of niet in je werkruimte.
409Conflict, bijvoorbeeld het bevestigen van een e-mailadres dat al bevestigd is.
422Validatie mislukt; zie errors. Als een abonnementslimiet is bereikt, noemt upgrade de functie die een groter abonnement ontgrendelt.
429Te veel verzoeken aan een begrensd endpoint; wacht het aantal seconden uit Retry-After.

Een validatiefout:

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

Monitors

Een monitor is één controle: een website, een SSL-certificaat, een ping, een TCP-poort, een DNS-record, een cron-heartbeat of de mailconfiguratie van een domein. Typen: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types vertelt welke typen, intervallen en locaties je abonnement bevat en wat de standaardwaarden van elk type zijn.

EndpointWat het doet
GET /monitors Opvragen; filters status, search, ids (kommagescheiden), with_stats=1 voegt uptime en laatste responstijd toe
POST /monitors Aanmaken; de controles starten op de achtergrond
GET /monitors/{id} Eén monitor met zijn locaties en open incident
PATCH /monitors/{id} Wijzigen; het type kan niet veranderen
DELETE /monitors/{id} Verwijderen (204)
POST /monitors/{id}/pause Pauzeren; een open incident wordt gesloten
POST /monitors/{id}/resume Hervatten
GET /check-types Typen, standaardwaarden en de limieten van je abonnement
GET /locations Actieve controlelocaties (code, name, country)

Velden bij het aanmaken

VeldBeschrijving
name Weergavenaam, maximaal 255 tekens. Verplicht.
type Een van de bovenstaande typen. Verplicht, daarna vast.
target URL, hostnaam, IP-adres of domein, afhankelijk van het type. Verplicht, behalve bij heartbeat, dat je in plaats daarvan een ping-URL geeft.
interval_seconds Controle-interval. Het minimum hangt af van je abonnement; GET /check-types geeft het terug als limits.min_interval_seconds.
locations Locatiecodes, bijvoorbeeld ["eu", "sg"]. Hoeveel je er mag kiezen, hangt af van je abonnement.
primary_location Hoofdlocatie die storingen als eerste bevestigt (Smart Verify).
confirm_locations Hoeveel locaties de storing moeten zien voordat je een melding krijgt (1–3). Instelbaar bij grotere abonnementen.
confirm_checks Hoeveel mislukte controles achter elkaar een storing bevestigen (1–3). Instelbaar bij grotere abonnementen.
options Per type. Voor http: method (GET, HEAD, POST), expected_status (bijv. 200-399 of 200,301), keyword met keyword_mode (present of absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Weggelaten opties nemen de standaardwaarden uit GET /check-types over.

Een websitecontrole met een trefwoord aanmaken:

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

Het antwoord (201) is de monitor. provisioning.state wordt synced zodra de locaties hem hebben overgenomen, status gaat na de eerste controle van pending naar up:

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

Statuswaarden: pending, up, degraded, down, paused.

Een monitor tijdens een deployment pauzeren en daarna hervatten:

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 en responstijden

Uptime wordt berekend uit storingen (incidenten met ernst major); waarschuwingen zoals een bijna verlopen certificaat tellen niet mee. Nog niet gecontroleerd betekent null, niet 100.

EndpointWat het doet
GET /monitors/{id}/uptime Uptime in procenten over de afgelopen 24 uur, 7 dagen en 30 dagen
GET /monitors/{id}/daily-uptime Uptime per kalenderdag (UTC), days 1–90, standaard 30
GET /monitors/{id}/response-times Responstijd en beschikbaarheid per locatie, range 24h, 7d of 30d; punten per uur, per dag bij 30d

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

Responstijden (ingekort):

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

Servers

Een server is een machine met de agent erop, die CPU, geheugen, belasting, schijven, netwerk en services doorgeeft. Bij het aanmaken van een server krijg je het eenmalige installatiecommando terug; voer het uit op de machine en de server verschijnt even later.

EndpointWat het doet
GET /servers Opvragen; filter ids
POST /servers Aanmaken; het antwoord bevat install_command (Linux) en install_command_freebsd
GET /servers/{id} Eén server met inventaris, laatste snapshot en drempelwaarden
PATCH /servers/{id} Hernoemen, de bewaakte services kiezen, thresholds instellen
DELETE /servers/{id} Verwijderen (204); de agent wordt uit de monitoring gehaald
POST /servers/{id}/pause Pauzeren; open incidenten worden gesloten
POST /servers/{id}/resume Hervatten
POST /servers/{id}/install-token Nieuw installatiecommando; rotate_key=true geeft ook een nieuwe agentsleutel uit
GET /servers/{id}/metrics Grafiekreeksen, range 24h, 7d of 30d: metric → context → [unix time, avg, min, max]
VeldBeschrijving
name Weergavenaam, maximaal 100 tekens. Verplicht bij het aanmaken.
services Servicenamen die de agent moet bewaken, bijvoorbeeld ["nginx", "php8.4-fpm", "mariadb"]; maximaal 200. De server meldt wat hij heeft gevonden onder discovered.services.
thresholds Drempelwaarden voor meldingen: cpu_max (procent), load_max_per_cpu, mem_min_pavail (procent vrij), fs_warn en fs_crit (procent in gebruik), inode_warn, agent_nodata_minutes, per koppelpunt onder filesystems, en de reguliere expressies fs_types, fs_exclude, net_exclude. Weggelaten waarden behouden de standaardwaarden.

Een server toevoegen en het installatiecommando uit het antwoord lezen:

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

Drie services bewaken en een melding sturen bij 80 procent schijfgebruik:

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

Incidenten

Een incident is één storing of waarschuwing van een monitor of server, van started_at tot resolved_at. Elk incident heeft zijn meldingsnummer, hetzelfde als in de e-mailmelding.

EndpointWat het doet
GET /incidents Nieuwste eerst; filters monitor_id, status (open of closed), open=1 (open storingen zonder mededelingen), from en to (datums)
GET /incidents/{id} Eén incident met zijn tijdlijn: wanneer welke locatie uitviel en herstelde, en de reparatie die het afhandelde

Open incidenten:

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

Handige velden: subject_type (monitor of server), severity (major, warning, info), cause (bijvoorbeeld unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations en, zolang het open is, failure_reason met de laatste controlewaarden.

Status pages

Een status page toont gekozen monitors aan het publiek of aan je team, onder ons domein of je eigen domein. Mededelingen kondigen onderhoud aan of leggen een lopend incident uit.

EndpointWat het doet
GET /status-pages Opvragen
POST /status-pages Aanmaken
GET /status-pages/{id} Eén pagina met monitors, mededelingen en de status van haar domeinen
PATCH /status-pages/{id} Wijzigen; monitors vervangt de hele lijst
DELETE /status-pages/{id} Verwijderen (204)
POST /status-pages/{id}/notices Een mededeling toevoegen
PUT /status-pages/{id}/notices/{notice} Een mededeling wijzigen
DELETE /status-pages/{id}/notices/{notice} Een mededeling verwijderen (204)
VeldBeschrijving
slug Adresdeel, 3–63 tekens, kleine letters, cijfers en koppeltekens; uniek. Verplicht.
title Kop van de pagina. Verplicht.
description Korte tekst onder de kop, maximaal 2000 tekens.
logo_url HTTPS-adres van een logo.
custom_domain Eigen domein zoals status.example.com; vereist een abonnement met eigen statusdomeinen.
is_public Openbaar (true) of alleen voor ingelogde gebruikers.
monitors Geordende lijst van {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name en group zijn optioneel.

Een mededeling heeft kind (maintenance, info of incident), title, body (optioneel, maximaal 5000 tekens), starts_at en een optionele ends_at.

Een openbare status page met twee monitors aanmaken:

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

Een onderhoudsvenster aankondigen:

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

Meldingskanalen

Een meldingskanaal is een manier om iemand te bereiken: een e-mailadres, een Telegram-chat, een webhook of de pushapparaten van een gebruiker. Een kanaal ontvangt de meldingen van alle monitors van de werkruimte, of alleen die van de monitors in monitor_ids. Welke kanaaltypen je abonnement bevat: GET /notification-channel-types.

EndpointWat het doet
GET /notification-channels Opvragen
POST /notification-channels Aanmaken; bij een webhook staat het ondertekenings-secret alleen in dit antwoord
GET /notification-channels/{id} Eén kanaal
PATCH /notification-channels/{id} Wijzigen; het type kan niet veranderen
DELETE /notification-channels/{id} Verwijderen (204)
POST /notification-channels/{id}/test Een testmelding sturen (202); een onbevestigd e-mailadres krijgt in plaats daarvan opnieuw zijn bevestigingslink
GET /notification-channel-types Kanaaltypen met available en paid
VeldBeschrijving
type email, telegram, webhook of push. Verplicht, daarna vast.
name Weergavenaam. Verplicht.
config Per type: {"email": "…"}, {"chat_id": "…"} of {"url": "https://…"}. Push heeft geen configuratie nodig. Een nieuw e-mailadres moet via een link worden bevestigd voordat er meldingen worden verstuurd.
monitor_ids UUID's van de monitors waarvoor dit kanaal geldt; laat het weg voor alle monitors.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: geen meldingen in dat tijdvak.
escalation_delay_minutes Dit kanaal pas waarschuwen als een storing zo lang duurt (0–1440).
notify_recovery Ook het herstelbericht sturen (true of false).
is_active Het kanaal aan- of uitzetten zonder het te verwijderen.

Een webhook-kanaal voor twee monitors aanmaken en het secret bewaren:

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

Een webhook-kanaal POST elke melding als JSON naar je URL, met een time-out van 10 seconden en zonder redirects. Het doel moet een openbaar adres zijn.

Headers: X-Webhook-Timestamp (Unix-tijd), X-Webhook-Signature (sha256= gevolgd door de HMAC-SHA256 van <timestamp>.<body> met het kanaalsecret als sleutel) en User-Agent: Uptime-Webhook/1.

event is down, recovered, paused of test. Bij een monitormelding bevat de body monitor (id, name, target) en incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); bij een servermelding server (id, name) en incident met problem in plaats van de locaties. subject is de kop van de melding in de taal van het kanaal.

Body van een down-melding:

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

Controleer de handtekening voordat je de body vertrouwt: bereken de HMAC over de ruwe body precies zoals ontvangen en vergelijk in constante tijd. Weiger tijdstempels die ouder zijn dan een paar minuten.

De handtekening in een shell controleren:

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

Dashboardoverzicht

GET /dashboard geeft de aantallen achter de tegels van het overzicht: monitors per status (servers tellen mee met hun abonnementseenheden), servers per status en het aantal open incidenten. Elk van de scopes monitors:read, servers:read of incidents:read geeft toegang.

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

Veelgestelde vragen

Welk abonnement bevat de API?

API-tokens zijn beschikbaar vanaf het Business-abonnement. Bij kleinere abonnementen zie je het onderdeel onder Mijn account grijs, met een upgradelink. Al het andere in Centoculus werkt zonder de API.

Kan een token alles wat mijn account kan?

Nee. Een token bereikt alleen de onderdelen waarvoor je het scopes hebt gegeven, en nooit facturering, teamleden, andere tokens, accountbeveiliging of reparaties. Die blijven in de app.

Is er een sandbox?

Gebruik om te verkennen een token met alleen leesscopes en maak testmonitors aan op het gratis abonnement van een tweede account. Monitors die je aanmaakt tellen mee voor je abonnement, net als die uit de app.

Hoe krijg ik meldingen in mijn eigen systeem?

Maak een webhook-kanaal aan en controleer de handtekening van elke levering. Elke storing, elk herstel en elke pauze bereikt je URL binnen seconden, met de monitor, de oorzaak en de getroffen locaties als JSON.

Verandert de API?

De versie staat in het adres (/api/v1). Nieuwe velden kunnen op elk moment aan antwoorden worden toegevoegd; binnen een versie worden velden niet verwijderd of hernoemd. Lees wat je nodig hebt en negeer de rest.

Klaar om je monitoring te automatiseren?

API-tokens zijn inbegrepen vanaf het Business-abonnement. Vergelijk de abonnementen, of begin gratis en upgrade zodra je scripts klaar zijn.