API til uptime-overvågning
Alt, du gør i appen, kan du også gøre via REST API'et: opret monitorer fra din deployment-pipeline, hent oppetid og svartider ind i dine egne dashboards, hold statussider og alarmkanaler synkroniseret. JSON ind, JSON ud, ét Bearer-token. API-tokens følger med fra Business-abonnementet.
Kom i gang
Basis-URL
https://app.centoculus.com/api/v1
Hver forespørgsel har to headers: Authorization: Bearer <token> og Accept: application/json. Forespørgsler med indhold sender JSON med Content-Type: application/json.
- Opret et token under Min konto → API-tokens i webappen eller mobilappen, og vælg dets scopes.
- Kopier tokenet med det samme; det vises kun én gang.
- Kald
GET /me. Det virker med alle tokens og fortæller, hvem tokenet tilhører.
Dit første kald:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
Svaret er din bruger med rolle, sprog og de arbejdsområder, tokenet kan nå (forkortet):
{
"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 og scopes
Et token har et navn, en valgfri udløbsdato (op til 730 dage) og de scopes, det må bruge. Vælg kun de scopes, en integration har brug for: et dashboard får monitors:read og incidents:read, et deployment-script får monitors:write. I abonnementer under Business er afsnittet synligt, men nedtonet.
| Scope | Tillader |
|---|---|
monitors:read | Vis lister over og enkelte monitorer, oppetid, daglig oppetid, svartider, kontroltyper, lokationer, dashboard-oversigt |
monitors:write | Opret, opdater, slet, sæt på pause og genoptag monitorer |
servers:read | Vis lister over og enkelte servere og deres målinger |
servers:write | Opret, opdater, slet, sæt på pause og genoptag servere; ny installationskommando til agenten |
incidents:read | Vis lister over og enkelte hændelser, dashboard-oversigt |
status-pages:read | Vis lister over og enkelte statussider |
status-pages:write | Opret, opdater og slet statussider og deres meddelelser |
notifications:read | Vis lister over og enkelte notifikationskanaler og kanaltyper |
notifications:write | Opret, opdater og slet kanaler (e-mail, Telegram, webhook, push), send en test |
GET /me virker med alle tokens. Fakturering, team, tokens, kontosikkerhed og reparationer (fixes) kan ikke nås med et API-token og svarer 403, ligesom et kald uden det rigtige scope.
Træk et token tilbage samme sted; det holder op med at virke med det samme.
Konventioner
- Svar er JSON. Et enkelt objekt ligger under
data, en liste underdatasammen medlinksogmeta. - Monitorer og servere adresseres med UUID; hændelser, statussider og notifikationskanaler med et numerisk id.
- Tidspunkter er ISO 8601 i UTC, for eksempel
2026-11-15T08:30:00.000000Z. - Lister er opdelt i sider med forespørgselsparametrene
pageogper_page;metaindeholdercurrent_page,last_page,per_pageogtotal. Standardsidestørrelser: monitorer 15 (maks. 200), hændelser 25 (maks. 100), notifikationskanaler 50, servere 100, statussider 15. - Konti med flere arbejdsområder (partnere og resellere) angiver
customer_id, når de opretter noget, og kan filtrere lister med den. Kundekonti udelader den. - Der er ingen generel kvote for forespørgsler. Nogle få endpoints er begrænset, for eksempel gensendelse af en e-mailbekræftelse (10 pr. minut); de svarer 429 med
Retry-After. Forespørg ikke oftere end dit kontrolinterval; brug en webhook-kanal til live-data.
Fejl
Fejl er JSON med en message. Valideringsfejl tilføjer errors med en liste af meddelelser pr. felt.
| Status | Betydning |
|---|---|
401 | Manglende, ugyldigt, udløbet eller tilbagekaldt token. |
402 | Overvågningen er sat på pause, fordi det forudbetalte tilgodehavende er brugt op (reseller-kunder); den genoptages efter en optankning. |
403 | Tokenet mangler scope, endpointet er lukket for API-tokens, eller dit abonnement indeholder ikke funktionen. |
404 | Findes ikke, eller ligger ikke i dit arbejdsområde. |
409 | Konflikt, for eksempel bekræftelse af en e-mailadresse, der allerede er bekræftet. |
422 | Validering mislykkedes; se errors. Når en abonnementsgrænse nås, angiver upgrade den funktion, et større abonnement låser op for. |
429 | For mange forespørgsler til et begrænset endpoint; vent det antal sekunder, Retry-After angiver. |
En valideringsfejl:
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."]
}
}
Monitorer
En monitor er én kontrol: en hjemmeside, et SSL-certifikat, en ping, en TCP-port, en DNS-post, et cron-heartbeat eller mailopsætningen for et domæne. Typer: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types fortæller, hvilke typer, intervaller og lokationer dit abonnement indeholder, og standardværdierne for hver type.
| Endpoint | Hvad det gør |
|---|---|
GET /monitors |
Liste; filtre status, search, ids (kommasepareret), with_stats=1 tilføjer oppetid og seneste svartid |
POST /monitors |
Opret; kontrollerne starter i baggrunden |
GET /monitors/{id} |
Én monitor med sine lokationer og åbne hændelse |
PATCH /monitors/{id} |
Opdater; typen kan ikke ændres |
DELETE /monitors/{id} |
Slet (204) |
POST /monitors/{id}/pause |
Sæt på pause; en åben hændelse lukkes |
POST /monitors/{id}/resume |
Genoptag |
GET /check-types |
Typer, standardværdier og dit abonnements grænser |
GET /locations |
Aktive kontrollokationer (code, name, country) |
Felter ved oprettelse
| Felt | Beskrivelse |
|---|---|
name |
Visningsnavn, op til 255 tegn. Påkrævet. |
type |
En af typerne ovenfor. Påkrævet, kan ikke ændres bagefter. |
target |
URL, værtsnavn, IP-adresse eller domæne, afhængigt af typen. Påkrævet undtagen for heartbeat, som i stedet giver dig en ping-URL. |
interval_seconds |
Kontrolinterval. Minimum afhænger af dit abonnement; GET /check-types returnerer det som limits.min_interval_seconds. |
locations |
Lokationskoder, for eksempel ["eu", "sg"]. Hvor mange du må vælge, afhænger af dit abonnement. |
primary_location |
Hovedlokation, der bekræfter nedbrud først (Smart Verify). |
confirm_locations |
Hvor mange lokationer der skal se fejlen, før du får alarm (1–3). Kan indstilles i større abonnementer. |
confirm_checks |
Hvor mange mislykkede kontroller i træk der bekræfter et nedbrud (1–3). Kan indstilles i større abonnementer. |
options |
Pr. type. For http: method (GET, HEAD, POST), expected_status (f.eks. 200-399 eller 200,301), keyword med keyword_mode (present eller absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Udeladte indstillinger får standardværdierne fra GET /check-types. |
Opret en hjemmesidekontrol med et nøgleord:
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"}
}'
Svaret (201) er monitoren. provisioning.state skifter til synced, så snart lokationerne har overtaget den, og status fra pending til up efter den første kontrol:
{
"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"
}
}
Statusværdier: pending, up, degraded, down, paused.
Sæt en monitor på pause under en deployment, og genoptag den bagefter:
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"
Oppetid og svartider
Oppetid beregnes ud fra nedbrud (hændelser med alvorlighed major); advarsler som et certifikat, der snart udløber, tæller ikke med. Endnu ikke kontrolleret betyder null, ikke 100.
| Endpoint | Hvad det gør |
|---|---|
GET /monitors/{id}/uptime |
Oppetid i procent for de seneste 24 timer, 7 dage og 30 dage |
GET /monitors/{id}/daily-uptime |
Oppetid pr. kalenderdag (UTC), days 1–90, standard 30 |
GET /monitors/{id}/response-times |
Svartid og tilgængelighed pr. lokation, range 24h, 7d eller 30d; timepunkter, daglige for 30d |
Oppetid:
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}}
Svartider (forkortet):
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}
]
}
}
}
Servere
En server er en maskine med agenten installeret, som rapporterer CPU, hukommelse, belastning, diske, netværk og tjenester. Når du opretter en server, får du en installationskommando til engangsbrug; kør den på maskinen, og serveren dukker op et øjeblik efter.
| Endpoint | Hvad det gør |
|---|---|
GET /servers |
Liste; filter ids |
POST /servers |
Opret; svaret indeholder install_command (Linux) og install_command_freebsd |
GET /servers/{id} |
Én server med inventar, seneste snapshot og tærskelværdier |
PATCH /servers/{id} |
Omdøb, vælg de overvågede services, angiv thresholds |
DELETE /servers/{id} |
Slet (204); agenten fjernes fra overvågningen |
POST /servers/{id}/pause |
Sæt på pause; åbne hændelser lukkes |
POST /servers/{id}/resume |
Genoptag |
POST /servers/{id}/install-token |
Ny installationskommando; rotate_key=true udsteder også en ny agentnøgle |
GET /servers/{id}/metrics |
Diagramserier, range 24h, 7d eller 30d: måling → kontekst → [unix time, avg, min, max] |
| Felt | Beskrivelse |
|---|---|
name |
Visningsnavn, op til 100 tegn. Påkrævet ved oprettelse. |
services |
Tjenestenavne, agenten skal overvåge, for eksempel ["nginx", "php8.4-fpm", "mariadb"]; op til 200. Serveren rapporterer, hvad den fandt, under discovered.services. |
thresholds |
Alarmtærskler: cpu_max (procent), load_max_per_cpu, mem_min_pavail (procent ledig), fs_warn og fs_crit (procent brugt), inode_warn, agent_nodata_minutes, pr. monteringspunkt under filesystems og de regulære udtryk fs_types, fs_exclude, net_exclude. Udeladte værdier beholder standardværdierne. |
Tilføj en server, og læs installationskommandoen i svaret:
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"
}
}
Overvåg tre tjenester, og giv alarm ved 80 procent diskforbrug:
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}
}'
Hændelser
En hændelse er ét nedbrud eller én advarsel for en monitor eller server, fra started_at til resolved_at. Hver hændelse har sit alarmnummer, det samme som alarm-mailen viser.
| Endpoint | Hvad det gør |
|---|---|
GET /incidents |
Nyeste først; filtre monitor_id, status (open eller closed), open=1 (åbne nedbrud uden meddelelser), from og to (datoer) |
GET /incidents/{id} |
Én hændelse med sin tidslinje: hvornår hvilken lokation gik ned og kom op igen, og den reparation (fix), der løste den |
Åbne hændelser:
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}
}
Nyttige felter: subject_type (monitor eller server), severity (major, warning, info), cause (for eksempel unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations og, mens hændelsen er åben, failure_reason med de seneste kontrolværdier.
Statussider
En statusside viser udvalgte monitorer for offentligheden eller dit team, under vores domæne eller dit eget. Meddelelser varsler vedligeholdelse eller forklarer en igangværende hændelse.
| Endpoint | Hvad det gør |
|---|---|
GET /status-pages |
Liste |
POST /status-pages |
Opret |
GET /status-pages/{id} |
Én side med monitorer, meddelelser og status for dens domæner |
PATCH /status-pages/{id} |
Opdater; monitors erstatter hele listen |
DELETE /status-pages/{id} |
Slet (204) |
POST /status-pages/{id}/notices |
Tilføj en meddelelse |
PUT /status-pages/{id}/notices/{notice} |
Opdater en meddelelse |
DELETE /status-pages/{id}/notices/{notice} |
Fjern en meddelelse (204) |
| Felt | Beskrivelse |
|---|---|
slug |
Adressedel, 3–63 tegn, små bogstaver, cifre og bindestreger; unik. Påkrævet. |
title |
Sidens overskrift. Påkrævet. |
description |
Kort tekst under overskriften, op til 2000 tegn. |
logo_url |
HTTPS-adresse på et logo. |
custom_domain |
Eget domæne som status.example.com; kræver et abonnement med egne statusdomæner. |
is_public |
Offentlig (true) eller kun for indloggede brugere. |
monitors |
Ordnet liste af {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name og group er valgfrie. |
En meddelelse har kind (maintenance, info eller incident), title, body (valgfri, op til 5000 tegn), starts_at og en valgfri ends_at.
Opret en offentlig statusside med to monitorer:
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"}
]
}'
Varsl et vedligeholdelsesvindue:
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"
}'
Notifikationskanaler
En notifikationskanal er én måde at nå nogen på: en e-mailadresse, en Telegram-chat, en webhook eller en brugers push-enheder. En kanal modtager alarmerne fra alle arbejdsområdets monitorer eller kun fra monitorerne i monitor_ids. Hvilke kanaltyper dit abonnement indeholder, viser GET /notification-channel-types.
| Endpoint | Hvad det gør |
|---|---|
GET /notification-channels |
Liste |
POST /notification-channels |
Opret; for en webhook findes signeringsnøglen secret kun i dette svar |
GET /notification-channels/{id} |
Én kanal |
PATCH /notification-channels/{id} |
Opdater; typen kan ikke ændres |
DELETE /notification-channels/{id} |
Slet (204) |
POST /notification-channels/{id}/test |
Send en testnotifikation (202); en ubekræftet e-mailadresse får i stedet sit bekræftelseslink igen |
GET /notification-channel-types |
Kanaltyper med available og paid |
| Felt | Beskrivelse |
|---|---|
type |
email, telegram, webhook eller push. Påkrævet, kan ikke ændres bagefter. |
name |
Visningsnavn. Påkrævet. |
config |
Pr. type: {"email": "…"}, {"chat_id": "…"} eller {"url": "https://…"}. Push kræver ingen config. En ny e-mailadresse skal bekræftes via link, før alarmer sendes. |
monitor_ids |
UUID'er for de monitorer, kanalen gælder for; udelad for alle monitorer. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: ingen alarmer i det tidsrum. |
escalation_delay_minutes |
Giv først denne kanal alarm, når et nedbrud har varet så længe (0–1440). |
notify_recovery |
Send også beskeden om, at alt er i orden igen (true eller false). |
is_active |
Slå kanalen til eller fra uden at slette den. |
Opret en webhook-kanal til to monitorer, og gem secret:
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
En webhook-kanal sender hver alarm som JSON med POST til din URL, med 10 sekunders timeout og uden omdirigeringer. Målet skal være en offentlig adresse.
Headers: X-Webhook-Timestamp (Unix-tid), X-Webhook-Signature (sha256= efterfulgt af HMAC-SHA256 af <timestamp>.<body> med kanalens secret som nøgle) og User-Agent: Uptime-Webhook/1.
event er down, recovered, paused eller test. For en monitoralarm indeholder bodyen monitor (id, name, target) og incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); for en serveralarm server (id, name) og incident med problem i stedet for lokationerne. subject er alarmens overskrift på kanalens sprog.
Body for en down-alarm:
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"
}
Verificér signaturen, før du stoler på indholdet: beregn HMAC over den rå body præcis som modtaget, og sammenlign i konstant tid. Afvis tidsstempler, der er ældre end nogle få minutter.
Kontrol af signaturen i en shell:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Dashboard-oversigt
GET /dashboard returnerer tallene bag felterne i oversigten: monitorer pr. status (servere tæller med deres abonnementsenheder), servere pr. status og antallet af åbne hændelser. Et af scopes monitors:read, servers:read eller incidents:read giver adgang.
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
}
}
Ofte stillede spørgsmål
Hvilket abonnement indeholder API'et?
API-tokens følger med fra Business-abonnementet. I mindre abonnementer ser du afsnittet under Min konto, nedtonet med et opgraderingslink. Alt andet i Centoculus virker uden API'et.
Kan ét token gøre alt, min konto kan?
Nej. Et token når kun de områder, du har givet det scopes til, og aldrig fakturering, teammedlemmer, andre tokens, kontosikkerhed eller reparationer (fixes). De bliver i appen.
Findes der en sandbox?
Brug et token med kun læse-scopes til at udforske, og opret testmonitorer i det gratis abonnement på en anden konto. Monitorer, du opretter, tæller med i dit abonnement ligesom dem, der oprettes i appen.
Hvordan får jeg alarmer ind i mit eget system?
Opret en webhook-kanal, og verificér signaturen på hver levering. Hvert nedbrud, hver genopretning og hver pause når din URL i løbet af sekunder, med monitoren, årsagen og de berørte lokationer som JSON.
Ændrer API'et sig?
Versionen står i adressen (/api/v1). Nye felter kan tilføjes i svar når som helst; felter fjernes eller omdøbes ikke inden for en version. Læs det, du har brug for, og ignorer resten.
Klar til at automatisere din overvågning?
API-tokens er inkluderet i Business-abonnementet og opefter. Sammenlign abonnementerne, eller start gratis og opgradér, når dine scripts er klar.