Hopp til innholdet
Centoculus

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.

  1. Opprett et token under Min konto → API-tokens i nettappen eller mobilappen, og velg scopes for det.
  2. Kopier tokenet med en gang; det vises bare én gang.
  3. 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.

ScopeTillater
monitors:readListe og vise monitorer, oppetid, daglig oppetid, responstider, kontrolltyper, lokasjoner, dashbordoversikt
monitors:writeOpprette, oppdatere, slette, pause og gjenoppta monitorer
servers:readListe og vise servere og målingene deres
servers:writeOpprette, oppdatere, slette, pause og gjenoppta servere; ny installasjonskommando for agenten
incidents:readListe og vise hendelser, dashbordoversikt
status-pages:readListe og vise statussider
status-pages:writeOpprette, oppdatere og slette statussider og meldingene deres
notifications:readListe og vise varslingskanaler og kanaltyper
notifications:writeOpprette, 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 under data sammen med links og meta.
  • 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 page og per_page; meta inneholder current_page, last_page, per_page og total. 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_id nå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.

StatusBetydning
401Manglende, ugyldig, utløpt eller tilbakekalt token.
402Overvåkingen er satt på pause fordi det forhåndsbetalte tilgodehavendet er brukt opp (forhandlerkunder); den gjenopptas etter påfyll.
403Tokenet mangler scope, endepunktet er stengt for API-tokens, eller planen din inkluderer ikke funksjonen.
404Finnes ikke, eller ligger ikke i arbeidsområdet ditt.
409Konflikt, for eksempel bekreftelse av en e-postadresse som allerede er bekreftet.
422Validering mislyktes; se errors. Når en plangrense nås, oppgir upgrade funksjonen en større plan låser opp.
429For 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.

EndepunktHva 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

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

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

EndepunktHva 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]
FeltBeskrivelse
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.

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

EndepunktHva 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)
FeltBeskrivelse
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.

EndepunktHva 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
FeltBeskrivelse
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.