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.
- Vytvořte token v části Můj účet → API tokeny ve webové nebo mobilní aplikaci a zvolte jeho scopes.
- Token si ihned zkopírujte; zobrazí se pouze jednou.
- 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á.
| Scope | Povoluje |
|---|---|
monitors:read | Výpis a detail monitorů, uptime, denní uptime, doby odezvy, typy kontrol, lokality, souhrn dashboardu |
monitors:write | Vytváření, úprava, mazání, pozastavení a obnovení monitorů |
servers:read | Výpis a detail serverů a jejich metrik |
servers:write | Vytváření, úprava, mazání, pozastavení a obnovení serverů; nový instalační příkaz pro agenta |
incidents:read | Výpis a detail incidentů, souhrn dashboardu |
status-pages:read | Výpis a detail stavových stránek |
status-pages:write | Vytváření, úprava a mazání stavových stránek a jejich oznámení |
notifications:read | Výpis a detail kanálů upozornění a typů kanálů |
notifications:write | Vytvář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 poddataspolu slinksameta. - 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
pageaper_page;metaobsahujecurrent_page,last_page,per_pageatotal. 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_ida 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.
| Status | Význam |
|---|---|
401 | Chybějící, neplatný, expirovaný nebo zrušený token. |
402 | Monitoring je pozastaven, protože se vyčerpal předplacený zůstatek (zákazníci resellerů); po dobití se obnoví. |
403 | Tokenu chybí scope, endpoint je pro API tokeny uzavřen, nebo váš tarif danou funkci neobsahuje. |
404 | Nenalezeno, nebo mimo váš workspace. |
409 | Konflikt, například potvrzení e-mailové adresy, která už je potvrzená. |
422 | Validace selhala; viz errors. Pokud narazíte na limit tarifu, upgrade pojmenuje funkci, kterou odemkne vyšší tarif. |
429 | Pří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.
| Endpoint | Co 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í
| Pole | Popis |
|---|---|
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.
| Endpoint | Co 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í.
| Endpoint | Co 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] |
| Pole | Popis |
|---|---|
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.
| Endpoint | Co 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.
| Endpoint | Co 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) |
| Pole | Popis |
|---|---|
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.
| Endpoint | Co 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 |
| Pole | Popis |
|---|---|
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é.