API for oppetidsovervåking
Alt du gjør i appen, kan du også gjøre via REST API-et: opprett monitorer fra deployment-pipelinen din, hent oppetid og responstider inn i dine egne dashbord, hold statussider og varslingskanaler synkronisert. JSON inn, JSON ut, ett Bearer-token. API-tokens følger med fra Business-planen.
Kom i gang
Basis-URL
https://app.centoculus.com/api/v1
Hver forespørsel har to headere: Authorization: Bearer <token> og Accept: application/json. Forespørsler med innhold sender JSON med Content-Type: application/json.
- Opprett et token under Min konto → API-tokens i nettappen eller mobilappen, og velg scopes for det.
- Kopier tokenet med en gang; det vises bare én gang.
- Kall
GET /me. Det fungerer med alle tokens og forteller hvem tokenet tilhører.
Ditt første kall:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
Svaret er brukeren din med rolle, språk og arbeidsområdene tokenet når (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 utløpsdato (opptil 730 dager) og de scopes det kan bruke. Velg bare de scopes en integrasjon trenger: et dashbord får monitors:read og incidents:read, et deployment-skript får monitors:write. I planer under Business er delen synlig, men nedtonet.
| Scope | Tillater |
|---|---|
monitors:read | Liste og vise monitorer, oppetid, daglig oppetid, responstider, kontrolltyper, lokasjoner, dashbordoversikt |
monitors:write | Opprette, oppdatere, slette, pause og gjenoppta monitorer |
servers:read | Liste og vise servere og målingene deres |
servers:write | Opprette, oppdatere, slette, pause og gjenoppta servere; ny installasjonskommando for agenten |
incidents:read | Liste og vise hendelser, dashbordoversikt |
status-pages:read | Liste og vise statussider |
status-pages:write | Opprette, oppdatere og slette statussider og meldingene deres |
notifications:read | Liste og vise varslingskanaler og kanaltyper |
notifications:write | Opprette, oppdatere og slette kanaler (e-post, Telegram, webhook, push), sende en test |
GET /me fungerer med alle tokens. Fakturering, team, tokens, kontosikkerhet og reparasjoner (fixes) kan ikke nås med et API-token og svarer 403, det samme gjelder et kall uten riktig scope.
Tilbakekall et token på samme sted; det slutter å virke umiddelbart.
Konvensjoner
- Svar er JSON. Et enkelt objekt ligger under
data, en liste underdatasammen medlinksogmeta. - Monitorer og servere adresseres med UUID; hendelser, statussider og varslingskanaler med en numerisk id.
- Tidspunkter er ISO 8601 i UTC, for eksempel
2026-11-15T08:30:00.000000Z. - Lister deles opp i sider med spørringsparametrene
pageogper_page;metainneholdercurrent_page,last_page,per_pageogtotal. Standard sidestørrelse: monitorer 15 (maks. 200), hendelser 25 (maks. 100), varslingskanaler 50, servere 100, statussider 15. - Kontoer med flere arbeidsområder (partnere og forhandlere) oppgir
customer_idnår de oppretter noe, og kan filtrere lister med den. Kundekontoer utelater den. - Det finnes ingen generell kvote for forespørsler. Noen få endepunkter er begrenset, for eksempel ny sending av e-postbekreftelse (10 per minutt); de svarer 429 med
Retry-After. Ikke spør oftere enn kontrollintervallet ditt; bruk en webhook-kanal for live-data.
Feil
Feil er JSON med en message. Valideringsfeil legger til errors med en liste over meldinger per felt.
| Status | Betydning |
|---|---|
401 | Manglende, ugyldig, utløpt eller tilbakekalt token. |
402 | Overvåkingen er satt på pause fordi det forhåndsbetalte tilgodehavendet er brukt opp (forhandlerkunder); den gjenopptas etter påfyll. |
403 | Tokenet mangler scope, endepunktet er stengt for API-tokens, eller planen din inkluderer ikke funksjonen. |
404 | Finnes ikke, eller ligger ikke i arbeidsområdet ditt. |
409 | Konflikt, for eksempel bekreftelse av en e-postadresse som allerede er bekreftet. |
422 | Validering mislyktes; se errors. Når en plangrense nås, oppgir upgrade funksjonen en større plan låser opp. |
429 | For mange forespørsler til et begrenset endepunkt; vent så mange sekunder som Retry-After angir. |
En valideringsfeil:
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 kontroll: en nettside, et SSL-sertifikat, en ping, en TCP-port, en DNS-post, et cron-heartbeat eller e-postoppsettet til et domene. Typer: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types forteller hvilke typer, intervaller og lokasjoner planen din inneholder, og standardverdiene for hver type.
| Endepunkt | Hva det gjør |
|---|---|
GET /monitors |
Liste; filtre status, search, ids (kommaseparert), with_stats=1 legger til oppetid og siste responstid |
POST /monitors |
Opprett; kontrollene starter i bakgrunnen |
GET /monitors/{id} |
Én monitor med lokasjoner og åpen hendelse |
PATCH /monitors/{id} |
Oppdater; typen kan ikke endres |
DELETE /monitors/{id} |
Slett (204) |
POST /monitors/{id}/pause |
Sett på pause; en åpen hendelse lukkes |
POST /monitors/{id}/resume |
Gjenoppta |
GET /check-types |
Typer, standardverdier og grensene i planen din |
GET /locations |
Aktive kontrolllokasjoner (code, name, country) |
Felt ved opprettelse
| Felt | Beskrivelse |
|---|---|
name |
Visningsnavn, opptil 255 tegn. Påkrevd. |
type |
En av typene ovenfor. Påkrevd, kan ikke endres etterpå. |
target |
URL, vertsnavn, IP-adresse eller domene, avhengig av typen. Påkrevd unntatt for heartbeat, som i stedet gir deg en ping-URL. |
interval_seconds |
Kontrollintervall. Minimum avhenger av planen din; GET /check-types returnerer det som limits.min_interval_seconds. |
locations |
Lokasjonskoder, for eksempel ["eu", "sg"]. Hvor mange du kan velge, avhenger av planen din. |
primary_location |
Hovedlokasjon som bekrefter nedetid først (Smart Verify). |
confirm_locations |
Hvor mange lokasjoner som må se feilen før du blir varslet (1–3). Kan konfigureres i større planer. |
confirm_checks |
Hvor mange mislykkede kontroller på rad som bekrefter nedetid (1–3). Kan konfigureres i større planer. |
options |
Per 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. Utelatte alternativer får standardverdiene fra GET /check-types. |
Opprett en nettsidekontroll med et nøkkelord:
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 går over til synced så snart lokasjonene har overtatt den, og status fra pending til up etter den første kontrollen:
{
"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"
}
}
Statusverdier: pending, up, degraded, down, paused.
Sett en monitor på pause under en deployment, og gjenoppta den etterpå:
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 responstider
Oppetid beregnes ut fra nedetid (hendelser med alvorlighetsgrad major); advarsler som et sertifikat som snart utløper, teller ikke. Ikke kontrollert ennå betyr null, ikke 100.
| Endepunkt | Hva det gjør |
|---|---|
GET /monitors/{id}/uptime |
Oppetid i prosent for de siste 24 timene, 7 dagene og 30 dagene |
GET /monitors/{id}/daily-uptime |
Oppetid per kalenderdag (UTC), days 1–90, standard 30 |
GET /monitors/{id}/response-times |
Responstid og tilgjengelighet per lokasjon, range 24h, 7d eller 30d; timespunkter, 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}}
Responstider (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 maskin med agenten installert, som rapporterer CPU, minne, belastning, disker, nettverk og tjenester. Når du oppretter en server, får du en installasjonskommando til engangsbruk; kjør den på maskinen, så dukker serveren opp et øyeblikk senere.
| Endepunkt | Hva det gjør |
|---|---|
GET /servers |
Liste; filter ids |
POST /servers |
Opprett; svaret inneholder install_command (Linux) og install_command_freebsd |
GET /servers/{id} |
Én server med inventar, siste øyeblikksbilde og terskelverdier |
PATCH /servers/{id} |
Gi nytt navn, velg de overvåkede services, angi thresholds |
DELETE /servers/{id} |
Slett (204); agenten fjernes fra overvåkingen |
POST /servers/{id}/pause |
Sett på pause; åpne hendelser lukkes |
POST /servers/{id}/resume |
Gjenoppta |
POST /servers/{id}/install-token |
Ny installasjonskommando; rotate_key=true utsteder også en ny agentnøkkel |
GET /servers/{id}/metrics |
Diagramserier, range 24h, 7d eller 30d: måling → kontekst → [unix time, avg, min, max] |
| Felt | Beskrivelse |
|---|---|
name |
Visningsnavn, opptil 100 tegn. Påkrevd ved opprettelse. |
services |
Tjenestenavn agenten skal overvåke, for eksempel ["nginx", "php8.4-fpm", "mariadb"]; opptil 200. Serveren rapporterer hva den fant, under discovered.services. |
thresholds |
Varslingsterskler: cpu_max (prosent), load_max_per_cpu, mem_min_pavail (prosent ledig), fs_warn og fs_crit (prosent brukt), inode_warn, agent_nodata_minutes, per monteringspunkt under filesystems og de regulære uttrykkene fs_types, fs_exclude, net_exclude. Utelatte verdier beholder standardverdiene. |
Legg til en server og les installasjonskommandoen 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åk tre tjenester og varsle ved 80 prosent diskbruk:
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}
}'
Hendelser
En hendelse er én nedetid eller én advarsel for en monitor eller server, fra started_at til resolved_at. Hver hendelse har sitt varselnummer, det samme som varsel-e-posten viser.
| Endepunkt | Hva det gjør |
|---|---|
GET /incidents |
Nyeste først; filtre monitor_id, status (open eller closed), open=1 (åpen nedetid uten meldinger), from og to (datoer) |
GET /incidents/{id} |
Én hendelse med tidslinjen: når hvilken lokasjon gikk ned og kom opp igjen, og reparasjonen (fix) som løste den |
Åpne hendelser:
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 felt: 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 hendelsen er åpen, failure_reason med de siste kontrollverdiene.
Statussider
En statusside viser utvalgte monitorer for offentligheten eller teamet ditt, under vårt domene eller ditt eget. Meldinger varsler vedlikehold eller forklarer en pågående hendelse.
| Endepunkt | Hva det gjør |
|---|---|
GET /status-pages |
Liste |
POST /status-pages |
Opprett |
GET /status-pages/{id} |
Én side med monitorer, meldinger og status for domenene |
PATCH /status-pages/{id} |
Oppdater; monitors erstatter hele listen |
DELETE /status-pages/{id} |
Slett (204) |
POST /status-pages/{id}/notices |
Legg til en melding |
PUT /status-pages/{id}/notices/{notice} |
Oppdater en melding |
DELETE /status-pages/{id}/notices/{notice} |
Fjern en melding (204) |
| Felt | Beskrivelse |
|---|---|
slug |
Adressedel, 3–63 tegn, små bokstaver, sifre og bindestreker; unik. Påkrevd. |
title |
Sidens overskrift. Påkrevd. |
description |
Kort tekst under overskriften, opptil 2000 tegn. |
logo_url |
HTTPS-adresse til en logo. |
custom_domain |
Eget domene som status.example.com; krever en plan med egne statusdomener. |
is_public |
Offentlig (true) eller bare for innloggede brukere. |
monitors |
Ordnet liste med {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name og group er valgfrie. |
En melding har kind (maintenance, info eller incident), title, body (valgfri, opptil 5000 tegn), starts_at og en valgfri ends_at.
Opprett 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"}
]
}'
Varsle om et vedlikeholdsvindu:
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"
}'
Varslingskanaler
En varslingskanal er én måte å nå noen på: en e-postadresse, en Telegram-chat, en webhook eller push-enhetene til en bruker. En kanal mottar varslene fra alle monitorene i arbeidsområdet, eller bare fra monitorene i monitor_ids. Hvilke kanaltyper planen din inkluderer, viser GET /notification-channel-types.
| Endepunkt | Hva det gjør |
|---|---|
GET /notification-channels |
Liste |
POST /notification-channels |
Opprett; for en webhook finnes signeringsnøkkelen secret bare i dette svaret |
GET /notification-channels/{id} |
Én kanal |
PATCH /notification-channels/{id} |
Oppdater; typen kan ikke endres |
DELETE /notification-channels/{id} |
Slett (204) |
POST /notification-channels/{id}/test |
Send et testvarsel (202); en ubekreftet e-postadresse får i stedet bekreftelseslenken sin på nytt |
GET /notification-channel-types |
Kanaltyper med available og paid |
| Felt | Beskrivelse |
|---|---|
type |
email, telegram, webhook eller push. Påkrevd, kan ikke endres etterpå. |
name |
Visningsnavn. Påkrevd. |
config |
Per type: {"email": "…"}, {"chat_id": "…"} eller {"url": "https://…"}. Push trenger ingen config. En ny e-postadresse må bekreftes via lenke før varsler sendes. |
monitor_ids |
UUID-er for monitorene kanalen gjelder; utelat for alle monitorer. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: ingen varsler i det tidsrommet. |
escalation_delay_minutes |
Varsle denne kanalen først når nedetiden har vart så lenge (0–1440). |
notify_recovery |
Send også beskjeden om at alt er i orden igjen (true eller false). |
is_active |
Slå kanalen på eller av uten å slette den. |
Opprett en webhook-kanal for to monitorer og ta vare på 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 hvert varsel som JSON med POST til URL-en din, med 10 sekunders tidsavbrudd og uten omdirigeringer. Målet må være en offentlig adresse.
Headere: X-Webhook-Timestamp (Unix-tid), X-Webhook-Signature (sha256= etterfulgt av HMAC-SHA256 av <timestamp>.<body> med kanalens secret som nøkkel) og User-Agent: Uptime-Webhook/1.
event er down, recovered, paused eller test. For et monitorvarsel inneholder bodyen monitor (id, name, target) og incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); for et servervarsel server (id, name) og incident med problem i stedet for lokasjonene. subject er overskriften på varselet på kanalens språk.
Body for et down-varsel:
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"
}
Verifiser signaturen før du stoler på innholdet: beregn HMAC over den rå bodyen nøyaktig slik den ble mottatt, og sammenlign i konstant tid. Avvis tidsstempler som er eldre enn noen få minutter.
Kontroll av signaturen i et skall:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Dashbordoversikt
GET /dashboard returnerer tallene bak rutene i oversikten: monitorer per status (servere teller med planenhetene sine), servere per status og antall åpne hendelser. Ett av scopene monitors:read, servers:read eller incidents:read gir tilgang.
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 stilte spørsmål
Hvilken plan inkluderer API-et?
API-tokens følger med fra Business-planen. I mindre planer ser du delen under Min konto, nedtonet med en oppgraderingslenke. Alt annet i Centoculus fungerer uten API-et.
Kan ett token gjøre alt kontoen min kan?
Nei. Et token når bare områdene du har gitt det scopes for, og aldri fakturering, teammedlemmer, andre tokens, kontosikkerhet eller reparasjoner (fixes). Disse blir i appen.
Finnes det en sandbox?
Bruk et token med bare lese-scopes til å utforske, og opprett testmonitorer i gratisplanen på en annen konto. Monitorer du oppretter, teller mot planen din på samme måte som de som opprettes i appen.
Hvordan får jeg varsler inn i mitt eget system?
Opprett en webhook-kanal og verifiser signaturen på hver levering. Hver nedetid, gjenoppretting og pause når URL-en din i løpet av sekunder, med monitoren, årsaken og de berørte lokasjonene som JSON.
Endrer API-et seg?
Versjonen står i adressen (/api/v1). Nye felt kan legges til i svar når som helst; felt fjernes eller omdøpes ikke innenfor en versjon. Les det du trenger, og ignorer resten.
Klar til å automatisere overvåkingen din?
API-tokens er inkludert i Business-planen og oppover. Sammenlign planene, eller start gratis og oppgrader når skriptene dine er klare.