API för uptime-övervakning
Allt du gör i appen kan du göra via REST API:et: skapa monitorer från din deployment-pipeline, hämta upptid och svarstider till dina egna dashboards, håll statussidor och larmkanaler synkade. JSON in, JSON ut, en Bearer-token. API-tokens ingår från Business-planen.
Kom igång
Bas-URL
https://app.centoculus.com/api/v1
Varje anrop har två headers: Authorization: Bearer <token> och Accept: application/json. Anrop med innehåll skickar JSON med Content-Type: application/json.
- Skapa en token under Mitt konto → API-tokens i webbappen eller mobilappen och välj dess scopes.
- Kopiera token direkt; den visas bara en gång.
- Anropa
GET /me. Det fungerar med alla tokens och visar vems token det är.
Ditt första anrop:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
Svaret är din användare med roll, språk och de arbetsytor som token når (förkortat):
{
"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 och scopes
En token har ett namn, ett valfritt utgångsdatum (upp till 730 dagar) och de scopes den får använda. Välj bara de scopes en integration behöver: en dashboard får monitors:read och incidents:read, ett deployment-skript får monitors:write. I planer under Business syns avsnittet men är nedtonat.
| Scope | Tillåter |
|---|---|
monitors:read | Lista och visa monitorer, upptid, daglig upptid, svarstider, kontrolltyper, platser, sammanfattning av dashboarden |
monitors:write | Skapa, ändra, ta bort, pausa och återuppta monitorer |
servers:read | Lista och visa servrar och deras mätvärden |
servers:write | Skapa, ändra, ta bort, pausa och återuppta servrar; nytt installationskommando för agenten |
incidents:read | Lista och visa incidenter, sammanfattning av dashboarden |
status-pages:read | Lista och visa statussidor |
status-pages:write | Skapa, ändra och ta bort statussidor och deras meddelanden |
notifications:read | Lista och visa notifieringskanaler och kanaltyper |
notifications:write | Skapa, ändra och ta bort kanaler (e-post, Telegram, webhook, push), skicka ett test |
GET /me fungerar med alla tokens. Fakturering, team, tokens, kontosäkerhet och åtgärder (fixes) kan inte nås med en API-token och svarar 403, precis som ett anrop utan rätt scope.
Återkalla en token på samma ställe; den slutar fungera direkt.
Konventioner
- Svaren är JSON. Ett enskilt objekt ligger under
data, en lista underdatamedlinksochmeta. - Monitorer och servrar adresseras med UUID; incidenter, statussidor och notifieringskanaler med ett numeriskt id.
- Tider anges enligt ISO 8601 i UTC, till exempel
2026-11-15T08:30:00.000000Z. - Listor sidindelas med frågeparametrarna
pageochper_page;metainnehållercurrent_page,last_page,per_pageochtotal. Standardstorlek per sida: monitorer 15 (max 200), incidenter 25 (max 100), notifieringskanaler 50, servrar 100, statussidor 15. - Konton med flera arbetsytor (partners och resellers) anger
customer_idnär något skapas och kan filtrera listor med den. Kundkonton utelämnar den. - Det finns ingen allmän anropskvot. Några få endpoints har begränsning, till exempel ny utskick av e-postbekräftelse (10 per minut); de svarar 429 med
Retry-After. Hämta inte oftare än ditt kontrollintervall; för livedata använd en webhook-kanal.
Fel
Fel returneras som JSON med ett message. Valideringsfel lägger till errors med en lista över meddelanden per fält.
| Status | Betydelse |
|---|---|
401 | Token saknas, är ogiltig, har gått ut eller har återkallats. |
402 | Övervakningen är pausad eftersom förbetalt saldo är slut (reseller-kunder); den återupptas efter en påfyllning. |
403 | Token saknar scope, endpointen är stängd för API-tokens eller din plan inkluderar inte funktionen. |
404 | Hittades inte, eller finns inte i din arbetsyta. |
409 | Konflikt, till exempel när en e-postadress som redan är bekräftad bekräftas igen. |
422 | Valideringen misslyckades; se errors. När en plangräns nås anger upgrade vilken funktion en större plan låser upp. |
429 | För många anrop till en begränsad endpoint; vänta så många sekunder som Retry-After anger. |
Ett valideringsfel:
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 är en kontroll: en webbplats, ett SSL-certifikat, en ping, en TCP-port, en DNS-post, en cron-heartbeat eller e-postkonfigurationen för en domän. Typer: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types visar vilka typer, intervall och platser din plan innehåller samt standardvärdena för varje typ.
| Endpoint | Vad den gör |
|---|---|
GET /monitors |
Lista; filter status, search, ids (kommaseparerade), with_stats=1 lägger till upptid och senaste svarstid |
POST /monitors |
Skapa; kontrollerna startar i bakgrunden |
GET /monitors/{id} |
En monitor med sina platser och öppen incident |
PATCH /monitors/{id} |
Ändra; typen kan inte ändras |
DELETE /monitors/{id} |
Ta bort (204) |
POST /monitors/{id}/pause |
Pausa; en öppen incident stängs |
POST /monitors/{id}/resume |
Återuppta |
GET /check-types |
Typer, standardvärden och gränserna i din plan |
GET /locations |
Aktiva kontrollplatser (code, name, country) |
Fält vid skapande
| Fält | Beskrivning |
|---|---|
name |
Visningsnamn, upp till 255 tecken. Obligatoriskt. |
type |
En av typerna ovan. Obligatoriskt, kan inte ändras efteråt. |
target |
URL, värdnamn, IP-adress eller domän, beroende på typ. Obligatoriskt utom för heartbeat, som i stället ger dig en ping-URL. |
interval_seconds |
Kontrollintervall. Minimivärdet beror på din plan; GET /check-types returnerar det som limits.min_interval_seconds. |
locations |
Platskoder, till exempel ["eu", "sg"]. Hur många du får välja beror på din plan. |
primary_location |
Huvudplats som bekräftar driftstopp först (Smart Verify). |
confirm_locations |
Hur många platser som måste se felet innan du får larm (1–3). Kan ställas in i större planer. |
confirm_checks |
Hur många misslyckade kontroller i rad som bekräftar ett driftstopp (1–3). Kan ställas in i större planer. |
options |
Per typ. För http: method (GET, HEAD, POST), expected_status (t.ex. 200-399 eller 200,301), keyword med keyword_mode (present eller absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Utelämnade alternativ får standardvärdena från GET /check-types. |
Skapa en webbplatskontroll med nyckelord:
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) är monitorn. provisioning.state blir synced så snart platserna har tagit över den, status går från pending till up efter den första 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"
}
}
Statusvärden: pending, up, degraded, down, paused.
Pausa en monitor under en deployment och återuppta den efteråt:
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"
Upptid och svarstider
Upptiden beräknas utifrån driftstopp (incidenter med allvarlighetsgrad major); varningar som ett certifikat som snart går ut räknas inte. Inte kontrollerad ännu betyder null, inte 100.
| Endpoint | Vad den gör |
|---|---|
GET /monitors/{id}/uptime |
Upptid i procent för de senaste 24 timmarna, 7 dagarna och 30 dagarna |
GET /monitors/{id}/daily-uptime |
Upptid per kalenderdag (UTC), days 1–90, standard 30 |
GET /monitors/{id}/response-times |
Svarstid och tillgänglighet per plats, range 24h, 7d eller 30d; timpunkter, dagliga för 30d |
Upptid:
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}}
Svarstider (förkortat):
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}
]
}
}
}
Servrar
En server är en maskin med agenten installerad, som rapporterar CPU, minne, belastning, diskar, nätverk och tjänster. När du skapar en server får du ett engångskommando för installation; kör det på maskinen så dyker servern upp efter en liten stund.
| Endpoint | Vad den gör |
|---|---|
GET /servers |
Lista; filter ids |
POST /servers |
Skapa; svaret innehåller install_command (Linux) och install_command_freebsd |
GET /servers/{id} |
En server med inventering, senaste ögonblicksbild och tröskelvärden |
PATCH /servers/{id} |
Byt namn, välj vilka services som övervakas, ange thresholds |
DELETE /servers/{id} |
Ta bort (204); agenten tas bort från övervakningen |
POST /servers/{id}/pause |
Pausa; öppna incidenter stängs |
POST /servers/{id}/resume |
Återuppta |
POST /servers/{id}/install-token |
Nytt installationskommando; rotate_key=true ger också en ny agentnyckel |
GET /servers/{id}/metrics |
Diagramserier, range 24h, 7d eller 30d: mätvärde → kontext → [unix time, avg, min, max] |
| Fält | Beskrivning |
|---|---|
name |
Visningsnamn, upp till 100 tecken. Obligatoriskt vid skapande. |
services |
Tjänstnamn som agenten ska övervaka, till exempel ["nginx", "php8.4-fpm", "mariadb"]; upp till 200. Servern rapporterar vad den hittade under discovered.services. |
thresholds |
Tröskelvärden för larm: cpu_max (procent), load_max_per_cpu, mem_min_pavail (procent ledigt), fs_warn och fs_crit (procent använt), inode_warn, agent_nodata_minutes, per monteringspunkt under filesystems, samt de reguljära uttrycken fs_types, fs_exclude, net_exclude. Utelämnade värden behåller standardvärdena. |
Lägg till en server och läs installationskommandot 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"
}
}
Övervaka tre tjänster och larma vid 80 procents diskanvändning:
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}
}'
Incidenter
En incident är ett driftstopp eller en varning för en monitor eller server, från started_at till resolved_at. Varje incident har sitt larmnummer, samma som visas i larmmejlet.
| Endpoint | Vad den gör |
|---|---|
GET /incidents |
Nyaste först; filter monitor_id, status (open eller closed), open=1 (öppna driftstopp utan meddelanden), from och to (datum) |
GET /incidents/{id} |
En incident med sin tidslinje: när vilken plats gick ner och återhämtade sig, och åtgärden (fix) som hanterade den |
Öppna incidenter:
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}
}
Användbara fält: subject_type (monitor eller server), severity (major, warning, info), cause (till exempel unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations och, så länge incidenten är öppen, failure_reason med de senaste kontrollvärdena.
Statussidor
En statussida visar utvalda monitorer för allmänheten eller för ditt team, under vår domän eller din egen. Meddelanden kungör underhåll eller förklarar en pågående incident.
| Endpoint | Vad den gör |
|---|---|
GET /status-pages |
Lista |
POST /status-pages |
Skapa |
GET /status-pages/{id} |
En sida med monitorer, meddelanden och status för dess domäner |
PATCH /status-pages/{id} |
Ändra; monitors ersätter hela listan |
DELETE /status-pages/{id} |
Ta bort (204) |
POST /status-pages/{id}/notices |
Lägg till ett meddelande |
PUT /status-pages/{id}/notices/{notice} |
Ändra ett meddelande |
DELETE /status-pages/{id}/notices/{notice} |
Ta bort ett meddelande (204) |
| Fält | Beskrivning |
|---|---|
slug |
Adressdel, 3–63 tecken, små bokstäver, siffror och bindestreck; unik. Obligatoriskt. |
title |
Sidans rubrik. Obligatoriskt. |
description |
Kort text under rubriken, upp till 2000 tecken. |
logo_url |
HTTPS-adress till en logotyp. |
custom_domain |
Egen domän som status.example.com; kräver en plan med egna statusdomäner. |
is_public |
Offentlig (true) eller bara för inloggade användare. |
monitors |
Ordnad lista med {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name och group är valfria. |
Ett meddelande har kind (maintenance, info eller incident), title, body (valfritt, upp till 5000 tecken), starts_at och ett valfritt ends_at.
Skapa en offentlig statussida med två 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"}
]
}'
Kungör ett underhållsfönster:
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"
}'
Notifieringskanaler
En notifieringskanal är ett sätt att nå någon: en e-postadress, en Telegram-chatt, en webhook eller en användares push-enheter. En kanal får larmen från alla monitorer i arbetsytan, eller bara från monitorerna i monitor_ids. Vilka kanaltyper din plan inkluderar visar GET /notification-channel-types.
| Endpoint | Vad den gör |
|---|---|
GET /notification-channels |
Lista |
POST /notification-channels |
Skapa; för en webhook finns signeringsnyckeln secret bara i det här svaret |
GET /notification-channels/{id} |
En kanal |
PATCH /notification-channels/{id} |
Ändra; typen kan inte ändras |
DELETE /notification-channels/{id} |
Ta bort (204) |
POST /notification-channels/{id}/test |
Skicka en testnotifiering (202); en obekräftad e-postadress får i stället sin bekräftelselänk igen |
GET /notification-channel-types |
Kanaltyper med available och paid |
| Fält | Beskrivning |
|---|---|
type |
email, telegram, webhook eller push. Obligatoriskt, kan inte ändras efteråt. |
name |
Visningsnamn. Obligatoriskt. |
config |
Per typ: {"email": "…"}, {"chat_id": "…"} eller {"url": "https://…"}. Push behöver ingen config. En ny e-postadress måste bekräftas via länk innan larm skickas. |
monitor_ids |
UUID för de monitorer kanalen gäller; utelämna för alla monitorer. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: inga larm under det tidsfönstret. |
escalation_delay_minutes |
Larma den här kanalen först när ett driftstopp har pågått så här länge (0–1440). |
notify_recovery |
Skicka också beskedet att allt är OK igen (true eller false). |
is_active |
Slå på eller av kanalen utan att ta bort den. |
Skapa en webhook-kanal för två monitorer och spara 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 skickar varje larm som JSON med POST till din URL, med 10 sekunders timeout och utan omdirigeringar. Målet måste vara en offentlig adress.
Headers: X-Webhook-Timestamp (Unix-tid), X-Webhook-Signature (sha256= följt av HMAC-SHA256 av <timestamp>.<body> med kanalens secret som nyckel) och User-Agent: Uptime-Webhook/1.
event är down, recovered, paused eller test. För ett monitorlarm innehåller bodyn monitor (id, name, target) och incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); för ett serverlarm server (id, name) och incident med problem i stället för platserna. subject är larmets rubrik på kanalens språk.
Body för ett down-larm:
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"
}
Verifiera signaturen innan du litar på innehållet: beräkna HMAC över den råa bodyn exakt som den mottogs och jämför i konstant tid. Avvisa tidsstämplar som är äldre än några minuter.
Kontrollera signaturen i ett skal:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Sammanfattning av dashboarden
GET /dashboard returnerar siffrorna bakom rutorna i översikten: monitorer per status (servrar räknas med sina planenheter), servrar per status och antalet öppna incidenter. Någon av monitors:read, servers:read eller incidents:read ger åtkomst.
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
}
}
Vanliga frågor
Vilken plan inkluderar API:et?
API-tokens ingår från Business-planen. I mindre planer ser du avsnittet under Mitt konto, nedtonat med en uppgraderingslänk. Allt annat i Centoculus fungerar utan API:et.
Kan en token göra allt mitt konto kan göra?
Nej. En token når bara de områden du gett den scopes för, och aldrig fakturering, teammedlemmar, andra tokens, kontosäkerhet eller åtgärder (fixes). De finns kvar i appen.
Finns det en sandbox?
Använd en token med enbart läs-scopes för att utforska, och skapa testmonitorer i gratisplanen på ett andra konto. Monitorer du skapar räknas mot din plan precis som de som skapas i appen.
Hur får jag in larm i mitt eget system?
Skapa en webhook-kanal och verifiera signaturen för varje leverans. Varje driftstopp, återhämtning och paus når din URL inom sekunder, med monitorn, orsaken och de påverkade platserna som JSON.
Ändras API:et?
Versionen finns i adressen (/api/v1). Nya fält kan läggas till i svaren när som helst; fält tas inte bort eller byter namn inom en version. Läs det du behöver och ignorera resten.
Redo att automatisera din övervakning?
API-tokens ingår i Business-planen och uppåt. Jämför planerna, eller börja gratis och uppgradera när dina skript är klara.