Přeskočit na obsah
Centoculus

API pro uptime monitoring

Vše, co děláte v aplikaci, zvládnete i přes REST API: vytvářejte monitory z deployment pipeline, přenášejte uptime a doby odezvy do vlastních dashboardů, udržujte stavové stránky a kanály upozornění v synchronizaci. JSON na vstupu, JSON na výstupu, jeden token Bearer. API tokeny jsou součástí tarifu Business a vyšších.

Začínáme

Základní URL

https://app.centoculus.com/api/v1

Každý požadavek nese dvě hlavičky: Authorization: Bearer <token> a Accept: application/json. Požadavky s tělem posílají JSON s hlavičkou Content-Type: application/json.

  1. Vytvořte token v části Můj účet → API tokeny ve webové nebo mobilní aplikaci a zvolte jeho scopes.
  2. Token si ihned zkopírujte; zobrazí se pouze jednou.
  3. Zavolejte GET /me. Funguje s každým tokenem a řekne vám, komu token patří.

Vaše první volání:

curl https://app.centoculus.com/api/v1/me \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json"

Odpovědí je váš uživatel s rolí, jazykem a workspaces, ke kterým token dosáhne (zkráceno):

{
  "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
  }
}

Tokeny a scopes

Token má název, volitelnou platnost (až 730 dní) a scopes, která smí používat. Vybírejte jen scopes, která integrace potřebuje: dashboard dostane monitors:read a incidents:read, deployment skript dostane monitors:write. V tarifech pod Business je tato sekce viditelná, ale zašedlá.

ScopePovoluje
monitors:readVýpis a detail monitorů, uptime, denní uptime, doby odezvy, typy kontrol, lokality, souhrn dashboardu
monitors:writeVytváření, úprava, mazání, pozastavení a obnovení monitorů
servers:readVýpis a detail serverů a jejich metrik
servers:writeVytváření, úprava, mazání, pozastavení a obnovení serverů; nový instalační příkaz pro agenta
incidents:readVýpis a detail incidentů, souhrn dashboardu
status-pages:readVýpis a detail stavových stránek
status-pages:writeVytváření, úprava a mazání stavových stránek a jejich oznámení
notifications:readVýpis a detail kanálů upozornění a typů kanálů
notifications:writeVytváření, úprava a mazání kanálů (e-mail, Telegram, webhook, push), odeslání testu

GET /me funguje s každým tokenem. Fakturace, tým, tokeny, zabezpečení účtu a opravy nejsou přes API token dostupné a odpovídají 403, stejně jako volání bez odpovídajícího scope.

Token zrušíte na stejném místě; přestane fungovat okamžitě.

Konvence

  • Odpovědi jsou ve formátu JSON. Jeden objekt přichází pod klíčem data, seznam pod data spolu s links a meta.
  • Monitory a servery se adresují přes UUID; incidenty, stavové stránky a kanály upozornění přes číselné id.
  • Časy jsou ve formátu ISO 8601 v UTC, například 2026-11-15T08:30:00.000000Z.
  • Seznamy se stránkují pomocí parametrů dotazu page a per_page; meta obsahuje current_page, last_page, per_page a total. Výchozí velikosti stránek: monitory 15 (max. 200), incidenty 25 (max. 100), kanály upozornění 50, servery 100, stavové stránky 15.
  • Účty s více workspaces (partneři a resellery) předávají při vytváření čehokoli customer_id a mohou jím filtrovat seznamy. Zákaznické účty ho vynechávají.
  • Obecný limit požadavků neexistuje. Několik endpointů je omezeno, například opakované odeslání potvrzení e-mailu (10 za minutu); odpovídají 429 s hlavičkou Retry-After. Dotazujte se nejvýše tak často, jak často běží kontroly; pro data v reálném čase použijte kanál webhook.

Chyby

Chyby jsou JSON se zprávou message. Chyby validace přidávají errors s jedním seznamem zpráv pro každé pole.

StatusVýznam
401Chybějící, neplatný, expirovaný nebo zrušený token.
402Monitoring je pozastaven, protože se vyčerpal předplacený zůstatek (zákazníci resellerů); po dobití se obnoví.
403Tokenu chybí scope, endpoint je pro API tokeny uzavřen, nebo váš tarif danou funkci neobsahuje.
404Nenalezeno, nebo mimo váš workspace.
409Konflikt, například potvrzení e-mailové adresy, která už je potvrzená.
422Validace selhala; viz errors. Pokud narazíte na limit tarifu, upgrade pojmenuje funkci, kterou odemkne vyšší tarif.
429Příliš mnoho požadavků na omezený endpoint; počkejte Retry-After sekund.

Chyba validace:

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."]
  }
}

Monitory

Monitor je jedna kontrola: web, certifikát SSL, ping, port TCP, záznam DNS, heartbeat úlohy cron nebo nastavení pošty domény. Typy: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types vám řekne, které typy, intervaly a lokality váš tarif zahrnuje, a také výchozí hodnoty každého typu.

EndpointCo dělá
GET /monitors Výpis; filtry status, search, ids (oddělené čárkou), with_stats=1 přidá uptime a poslední dobu odezvy
POST /monitors Vytvoření; kontroly se spustí na pozadí
GET /monitors/{id} Jeden monitor s lokalitami a otevřeným incidentem
PATCH /monitors/{id} Úprava; typ nelze změnit
DELETE /monitors/{id} Smazání (204)
POST /monitors/{id}/pause Pozastavení; otevřený incident se uzavře
POST /monitors/{id}/resume Obnovení
GET /check-types Typy, výchozí hodnoty a limity vašeho tarifu
GET /locations Aktivní lokality kontrol (code, name, country)

Pole při vytváření

PolePopis
name Zobrazovaný název, nejvýše 255 znaků. Povinné.
type Jeden z výše uvedených typů. Povinné, poté neměnné.
target URL, název hostitele, IP adresa nebo doména podle typu. Povinné kromě heartbeat, který místo toho vrací ping URL.
interval_seconds Interval kontroly. Minimum závisí na vašem tarifu; GET /check-types ho vrací jako limits.min_interval_seconds.
locations Kódy lokalit, například ["eu", "sg"]. Kolik jich smíte zvolit, závisí na vašem tarifu.
primary_location Hlavní lokalita, která výpadky potvrzuje jako první (Smart Verify).
confirm_locations Kolik lokalit musí selhání vidět, než dostanete upozornění (1–3). V dražších tarifech lze nastavit.
confirm_checks Kolik neúspěšných kontrol za sebou potvrdí výpadek (1–3). V dražších tarifech lze nastavit.
options Podle typu. Pro http: method (GET, HEAD, POST), expected_status (např. 200-399 nebo 200,301), keyword s keyword_mode (present nebo absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Vynechané volby převezmou výchozí hodnoty z GET /check-types.

Vytvoření kontroly webu s klíčovým slovem:

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"}
  }'

Odpovědí (201) je monitor. provisioning.state přejde na synced, jakmile ho lokality převezmou, status z pending na up po první kontrole:

{
  "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"
  }
}

Hodnoty statusu: pending, up, degraded, down, paused.

Pozastavte monitor během nasazení a poté ho obnovte:

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 a doby odezvy

Uptime se počítá z výpadků (incidentů se závažností major); varování, například blížící se konec platnosti certifikátu, se nepočítají. Dosud nekontrolováno znamená null, ne 100.

EndpointCo dělá
GET /monitors/{id}/uptime Uptime v procentech za posledních 24 hodin, 7 dní a 30 dní
GET /monitors/{id}/daily-uptime Uptime za kalendářní den (UTC), days 1–90, výchozí 30
GET /monitors/{id}/response-times Doba odezvy a dostupnost podle lokality, range 24h, 7d nebo 30d; hodinové body, u 30d denní

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}}

Doby odezvy (zkráceno):

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}
      ]
    }
  }
}

Servery

Server je stroj s nainstalovaným agentem, který hlásí CPU, paměť, zátěž, disky, síť a služby. Vytvoření serveru vrátí jednorázový instalační příkaz; spusťte ho na stroji a server se za chvíli objeví.

EndpointCo dělá
GET /servers Výpis; filtr ids
POST /servers Vytvoření; odpověď obsahuje install_command (Linux) a install_command_freebsd
GET /servers/{id} Jeden server s inventářem, posledním snímkem a prahovými hodnotami
PATCH /servers/{id} Přejmenování, výběr sledovaných services, nastavení thresholds
DELETE /servers/{id} Smazání (204); agent je odebrán z monitoringu
POST /servers/{id}/pause Pozastavení; otevřené incidenty se uzavřou
POST /servers/{id}/resume Obnovení
POST /servers/{id}/install-token Nový instalační příkaz; rotate_key=true vydá také nový klíč agenta
GET /servers/{id}/metrics Řady grafů, range 24h, 7d nebo 30d: metrika → kontext → [unix time, avg, min, max]
PolePopis
name Zobrazovaný název, nejvýše 100 znaků. Při vytváření povinné.
services Názvy služeb, které má agent sledovat, například ["nginx", "php8.4-fpm", "mariadb"]; nejvýše 200. Server hlásí, co našel, pod discovered.services.
thresholds Prahové hodnoty upozornění: cpu_max (procenta), load_max_per_cpu, mem_min_pavail (procenta volné), fs_warn a fs_crit (procenta využití), inode_warn, agent_nodata_minutes, podle přípojného bodu pod filesystems, a regulární výrazy fs_types, fs_exclude, net_exclude. Vynechané hodnoty si ponechají výchozí nastavení.

Přidejte server a z odpovědi přečtěte instalační příkaz:

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"
  }
}

Sledujte tři služby a upozorněte při 80 procentech využití disku:

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}
  }'

Incidenty

Incident je jeden výpadek nebo varování monitoru či serveru, od started_at do resolved_at. Každý incident nese své číslo upozornění, stejné, jaké ukazuje e-mail s upozorněním.

EndpointCo dělá
GET /incidents Nejnovější první; filtry monitor_id, status (open nebo closed), open=1 (otevřené výpadky bez oznámení), from a to (data)
GET /incidents/{id} Jeden incident s časovou osou: kdy která lokalita přestala fungovat a kdy se zotavila, a oprava, která ho vyřešila

Otevřené incidenty:

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}
}

Užitečná pole: subject_type (monitor nebo server), severity (major, warning, info), cause (například unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations a u otevřeného incidentu failure_reason s nejnovějšími hodnotami kontroly.

Stavové stránky

Stavová stránka ukazuje vybrané monitory veřejnosti nebo vašemu týmu, na naší doméně nebo na vaší vlastní. Oznámení ohlašují údržbu nebo vysvětlují probíhající incident.

EndpointCo dělá
GET /status-pages Výpis
POST /status-pages Vytvoření
GET /status-pages/{id} Jedna stránka s monitory, oznámeními a stavem jejích domén
PATCH /status-pages/{id} Úprava; monitors nahradí celý seznam
DELETE /status-pages/{id} Smazání (204)
POST /status-pages/{id}/notices Přidání oznámení
PUT /status-pages/{id}/notices/{notice} Úprava oznámení
DELETE /status-pages/{id}/notices/{notice} Odebrání oznámení (204)
PolePopis
slug Část adresy, 3–63 znaků, malá písmena, číslice a pomlčky; jedinečná. Povinné.
title Nadpis stránky. Povinné.
description Krátký text pod nadpisem, nejvýše 2000 znaků.
logo_url Adresa loga přes HTTPS.
custom_domain Vlastní doména, například status.example.com; vyžaduje tarif s vlastními doménami stavových stránek.
is_public Veřejná (true), nebo jen pro přihlášené uživatele.
monitors Seřazený seznam {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name a group jsou volitelné.

Oznámení má kind (maintenance, info nebo incident), title, body (volitelné, nejvýše 5000 znaků), starts_at a volitelné ends_at.

Vytvoření veřejné stavové stránky se dvěma monitory:

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"}
    ]
  }'

Ohlášení servisního okna:

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"
  }'

Kanály upozornění

Kanál upozornění je jeden způsob, jak někoho zastihnout: e-mailová adresa, chat v Telegramu, webhook nebo push zařízení uživatele. Kanál přijímá upozornění všech monitorů workspace, nebo jen monitorů v monitor_ids. Které typy kanálů váš tarif zahrnuje, zjistíte přes GET /notification-channel-types.

EndpointCo dělá
GET /notification-channels Výpis
POST /notification-channels Vytvoření; u webhooku je podpisové secret pouze v této odpovědi
GET /notification-channels/{id} Jeden kanál
PATCH /notification-channels/{id} Úprava; typ nelze změnit
DELETE /notification-channels/{id} Smazání (204)
POST /notification-channels/{id}/test Odeslání testovacího upozornění (202); nepotvrzená e-mailová adresa místo toho znovu dostane potvrzovací odkaz
GET /notification-channel-types Typy kanálů s available a paid
PolePopis
type email, telegram, webhook nebo push. Povinné, poté neměnné.
name Zobrazovaný název. Povinné.
config Podle typu: {"email": "…"}, {"chat_id": "…"} nebo {"url": "https://…"}. Push žádnou konfiguraci nepotřebuje. Nová e-mailová adresa musí být před odesláním upozornění potvrzena odkazem.
monitor_ids UUID monitorů, pro které je kanál určen; pro všechny monitory pole vynechte.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: v tomto okně žádná upozornění.
escalation_delay_minutes Upozornit tento kanál, až když výpadek trvá takto dlouho (0–1440).
notify_recovery Poslat také zprávu o obnovení (true nebo false).
is_active Kanál zapnout nebo vypnout bez smazání.

Vytvoření kanálu webhook pro dva monitory a uložení 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"
  }
}

Payload webhooku

Kanál webhook odesílá každé upozornění jako JSON přes POST na vaši URL, s timeoutem 10 sekund a bez přesměrování. Cíl musí být veřejná adresa.

Hlavičky: X-Webhook-Timestamp (Unix time), X-Webhook-Signature (sha256= následované HMAC-SHA256 z <timestamp>.<body> s secret kanálu jako klíčem) a User-Agent: Uptime-Webhook/1.

event je down, recovered, paused nebo test. U upozornění na monitor tělo obsahuje monitor (id, name, target) a incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); u upozornění na server server (id, name) a incident s problem místo lokalit. subject je nadpis upozornění v jazyce kanálu.

Tělo upozornění down:

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"
}

Podpis ověřte dříve, než tělu uvěříte: spočítejte HMAC z nezpracovaného těla přesně tak, jak dorazilo, a porovnejte ho v konstantním čase. Odmítněte časová razítka starší než několik minut.

Kontrola podpisu v shellu:

expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"

Souhrn dashboardu

GET /dashboard vrací počty za dlaždicemi přehledu: monitory podle statusu (servery se počítají se svými jednotkami tarifu), servery podle statusu a počet otevřených incidentů. Otevře ho kterýkoli ze scopes monitors:read, servers:read nebo incidents:read.

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
  }
}

Často kladené otázky

Který tarif zahrnuje API?

API tokeny jsou součástí tarifu Business a vyšších. V menších tarifech sekci vidíte v části Můj účet zašedlou s odkazem na upgrade. Všechno ostatní v Centoculus funguje i bez API.

Dokáže jeden token všechno, co můj účet?

Ne. Token dosáhne jen na oblasti, pro které jste mu dali scopes, a nikdy na fakturaci, členy týmu, jiné tokeny, zabezpečení účtu ani opravy. Ty zůstávají v aplikaci.

Existuje sandbox?

K prozkoumání použijte token jen s read scopes a testovací monitory vytvářejte v bezplatném tarifu druhého účtu. Monitory, které vytvoříte, se počítají do vašeho tarifu stejně jako ty z aplikace.

Jak dostanu upozornění do vlastního systému?

Vytvořte kanál webhook a u každého doručení ověřte podpis. Každý výpadek, obnovení i pozastavení dorazí na vaši URL během pár sekund, s monitorem, příčinou a dotčenými lokalitami jako JSON.

Mění se API?

Verze je součástí adresy (/api/v1). Do odpovědí mohou být kdykoli přidána nová pole; v rámci verze se pole neodebírají ani nepřejmenovávají. Čtěte, co potřebujete, a zbytek ignorujte.

Chcete automatizovat svůj monitoring?

API tokeny jsou součástí tarifu Business a vyšších. Porovnejte tarify, nebo začněte zdarma a přejděte na vyšší, až budou vaše skripty hotové.