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.
- Maak onder Mijn account → API-tokens in de web-app of de telefoon-app een token aan en kies de scopes.
- Kopieer het token meteen; het wordt maar één keer getoond.
- Roep
GET /meaan. 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.
| Scope | Staat toe |
|---|---|
monitors:read | Monitors, uptime, dagelijkse uptime, responstijden, controletypen, locaties en dashboardoverzicht opvragen en tonen |
monitors:write | Monitors aanmaken, wijzigen, verwijderen, pauzeren en hervatten |
servers:read | Servers en hun metrics opvragen en tonen |
servers:write | Servers aanmaken, wijzigen, verwijderen, pauzeren en hervatten; nieuw installatiecommando voor de agent |
incidents:read | Incidenten en dashboardoverzicht opvragen en tonen |
status-pages:read | Status pages opvragen en tonen |
status-pages:write | Status pages en hun mededelingen aanmaken, wijzigen en verwijderen |
notifications:read | Meldingskanalen en kanaaltypen opvragen en tonen |
notifications:write | Kanalen (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 onderdatametlinksenmeta. - 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
pageenper_page;metabevatcurrent_page,last_page,per_pageentotal. 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_idmee 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.
| Status | Betekenis |
|---|---|
401 | Token ontbreekt, is ongeldig, verlopen of ingetrokken. |
402 | De monitoring is gepauzeerd omdat het prepaidtegoed op is (resellerklanten); na het opwaarderen gaat het verder. |
403 | Het token mist de scope, het endpoint is gesloten voor API-tokens, of je abonnement bevat de functie niet. |
404 | Niet gevonden, of niet in je werkruimte. |
409 | Conflict, bijvoorbeeld het bevestigen van een e-mailadres dat al bevestigd is. |
422 | Validatie mislukt; zie errors. Als een abonnementslimiet is bereikt, noemt upgrade de functie die een groter abonnement ontgrendelt. |
429 | Te 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.
| Endpoint | Wat 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
| Veld | Beschrijving |
|---|---|
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.
| Endpoint | Wat 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.
| Endpoint | Wat 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] |
| Veld | Beschrijving |
|---|---|
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.
| Endpoint | Wat 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.
| Endpoint | Wat 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) |
| Veld | Beschrijving |
|---|---|
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.
| Endpoint | Wat 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 |
| Veld | Beschrijving |
|---|---|
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.