API pentru uptime monitoring
Tot ce faci în aplicație poți face și prin REST API: creează monitoare din pipeline-ul de deployment, preia uptime-ul și timpii de răspuns în propriile dashboard-uri, ține sincronizate paginile de status și canalele de alertă. JSON la intrare, JSON la ieșire, un singur token Bearer. Tokenurile API vin cu planul Business și cu cele de deasupra.
Primii pași
URL de bază
https://app.centoculus.com/api/v1
Fiecare cerere poartă două antete: Authorization: Bearer <token> și Accept: application/json. Cererile cu corp trimit JSON cu Content-Type: application/json.
- Creează un token la Contul meu → Tokenuri API în aplicația web sau în aplicația de telefon și alege scope-urile lui.
- Copiază tokenul imediat; este afișat o singură dată.
- Apelează
GET /me. Funcționează cu orice token și îți spune al cui este tokenul.
Primul tău apel:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
Răspunsul este utilizatorul tău cu rol, limbă și workspace-urile la care ajunge tokenul (prescurtat):
{
"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
}
}
Tokenuri și scope-uri
Un token are un nume, o expirare opțională (până la 730 de zile) și scope-urile pe care le poate folosi. Alege doar scope-urile de care are nevoie o integrare: un dashboard primește monitors:read și incidents:read, un script de deployment primește monitors:write. La planurile sub Business secțiunea este vizibilă, dar estompată.
| Scope | Permite |
|---|---|
monitors:read | Listarea și afișarea monitoarelor, uptime, uptime zilnic, timpi de răspuns, tipuri de verificări, locații, sumarul dashboard-ului |
monitors:write | Crearea, modificarea, ștergerea, punerea în pauză și reluarea monitoarelor |
servers:read | Listarea și afișarea serverelor și a metricilor lor |
servers:write | Crearea, modificarea, ștergerea, punerea în pauză și reluarea serverelor; comandă nouă de instalare pentru agent |
incidents:read | Listarea și afișarea incidentelor, sumarul dashboard-ului |
status-pages:read | Listarea și afișarea paginilor de status |
status-pages:write | Crearea, modificarea și ștergerea paginilor de status și a anunțurilor lor |
notifications:read | Listarea și afișarea canalelor de notificare și a tipurilor de canale |
notifications:write | Crearea, modificarea și ștergerea canalelor (e-mail, Telegram, webhook, push), trimiterea unui test |
GET /me funcționează cu orice token. Facturarea, echipa, tokenurile, securitatea contului și reparațiile nu pot fi accesate cu un token API și răspund cu 403, la fel ca un apel fără scope-ul potrivit.
Revocă un token în același loc; nu mai funcționează imediat.
Convenții
- Răspunsurile sunt JSON. Un singur obiect vine sub
data, o listă vine subdataîmpreună culinksșimeta. - Monitoarele și serverele se adresează prin UUID; incidentele, paginile de status și canalele de notificare printr-un id numeric.
- Orele sunt în format ISO 8601, în UTC, de exemplu
2026-11-15T08:30:00.000000Z. - Listele sunt paginate cu parametrii de interogare
pageșiper_page;metaconținecurrent_page,last_page,per_pageșitotal. Dimensiuni implicite ale paginilor: monitoare 15 (max. 200), incidente 25 (max. 100), canale de notificare 50, servere 100, pagini de status 15. - Conturile cu mai multe workspace-uri (parteneri și revânzători) transmit
customer_idcând creează ceva și pot filtra listele cu el. Conturile de client îl omit. - Nu există o cotă generală de cereri. Câteva endpoint-uri sunt limitate, de exemplu retrimiterea confirmării prin e-mail (10 pe minut); acestea răspund cu 429 și
Retry-After. Nu interoga mai des decât intervalul de verificare; pentru date în timp real folosește un canal webhook.
Erori
Erorile sunt JSON cu un message. Erorile de validare adaugă errors, cu o listă de mesaje pentru fiecare câmp.
| Status | Semnificație |
|---|---|
401 | Token lipsă, invalid, expirat sau revocat. |
402 | Monitorizarea este în pauză pentru că soldul prepaid s-a epuizat (clienții revânzătorilor); se reia după reîncărcare. |
403 | Tokenului îi lipsește scope-ul, endpoint-ul este închis pentru tokenurile API sau planul tău nu include funcția. |
404 | Negăsit sau în afara workspace-ului tău. |
409 | Conflict, de exemplu confirmarea unei adrese de e-mail deja confirmate. |
422 | Validarea a eșuat; vezi errors. Când se atinge o limită a planului, upgrade numește funcția pe care o deblochează un plan mai mare. |
429 | Prea multe cereri pe un endpoint limitat; așteaptă Retry-After secunde. |
O eroare de validare:
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."]
}
}
Monitoare
Un monitor este o verificare: un site, un certificat SSL, un ping, un port TCP, o înregistrare DNS, un heartbeat de cron sau configurația de e-mail a unui domeniu. Tipuri: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types îți spune ce tipuri, intervale și locații include planul tău și valorile implicite ale fiecărui tip.
| Endpoint | Ce face |
|---|---|
GET /monitors |
Listare; filtre status, search, ids (separate prin virgulă), with_stats=1 adaugă uptime-ul și ultimul timp de răspuns |
POST /monitors |
Creare; verificările pornesc în fundal |
GET /monitors/{id} |
Un monitor cu locațiile și incidentul deschis |
PATCH /monitors/{id} |
Modificare; tipul nu se poate schimba |
DELETE /monitors/{id} |
Ștergere (204) |
POST /monitors/{id}/pause |
Pauză; un incident deschis este închis |
POST /monitors/{id}/resume |
Reluare |
GET /check-types |
Tipuri, valori implicite și limitele planului tău |
GET /locations |
Locații active de verificare (code, name, country) |
Câmpuri la creare
| Câmp | Descriere |
|---|---|
name |
Nume afișat, până la 255 de caractere. Obligatoriu. |
type |
Unul dintre tipurile de mai sus. Obligatoriu, nu se mai schimbă. |
target |
URL, nume de gazdă, adresă IP sau domeniu, în funcție de tip. Obligatoriu, cu excepția heartbeat, care îți oferă în schimb un URL de ping. |
interval_seconds |
Intervalul de verificare. Minimul depinde de planul tău; GET /check-types îl returnează ca limits.min_interval_seconds. |
locations |
Coduri de locații, de exemplu ["eu", "sg"]. Câte poți alege depinde de planul tău. |
primary_location |
Locația principală care confirmă prima căderile (Smart Verify). |
confirm_locations |
Câte locații trebuie să vadă eșecul înainte să fii alertat (1–3). Configurabil la planurile mai mari. |
confirm_checks |
Câte verificări eșuate la rând confirmă o cădere (1–3). Configurabil la planurile mai mari. |
options |
Pe tip. Pentru http: method (GET, HEAD, POST), expected_status (de ex. 200-399 sau 200,301), keyword cu keyword_mode (present sau absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Opțiunile omise iau valorile implicite din GET /check-types. |
Creează o verificare de site cu un cuvânt-cheie:
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"}
}'
Răspunsul (201) este monitorul. provisioning.state devine synced imediat ce locațiile l-au preluat, status trece de la pending la up după prima verificare:
{
"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"
}
}
Valorile status: pending, up, degraded, down, paused.
Pune un monitor în pauză în timpul unui deployment și reia-l după aceea:
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 și timpi de răspuns
Uptime-ul se calculează din căderi (incidente cu severitatea major); avertismentele, precum un certificat care expiră, nu se numără. Încă neverificat înseamnă null, nu 100.
| Endpoint | Ce face |
|---|---|
GET /monitors/{id}/uptime |
Uptime în procente pentru ultimele 24 de ore, 7 zile și 30 de zile |
GET /monitors/{id}/daily-uptime |
Uptime pe zi calendaristică (UTC), days 1–90, implicit 30 |
GET /monitors/{id}/response-times |
Timp de răspuns și disponibilitate pe locație, range 24h, 7d sau 30d; puncte orare, zilnice pentru 30d |
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}}
Timpi de răspuns (prescurtat):
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
Un server este o mașină pe care rulează agentul, care raportează CPU, memorie, încărcare, discuri, rețea și servicii. Crearea unui server returnează comanda de instalare, valabilă o singură dată; rulează-o pe mașină și serverul apare după câteva momente.
| Endpoint | Ce face |
|---|---|
GET /servers |
Listare; filtru ids |
POST /servers |
Creare; răspunsul conține install_command (Linux) și install_command_freebsd |
GET /servers/{id} |
Un server cu inventar, ultimul instantaneu și praguri |
PATCH /servers/{id} |
Redenumire, alegerea services urmărite, setarea thresholds |
DELETE /servers/{id} |
Ștergere (204); agentul este scos din monitorizare |
POST /servers/{id}/pause |
Pauză; incidentele deschise sunt închise |
POST /servers/{id}/resume |
Reluare |
POST /servers/{id}/install-token |
Comandă nouă de instalare; rotate_key=true emite și o cheie nouă pentru agent |
GET /servers/{id}/metrics |
Serii pentru grafice, range 24h, 7d sau 30d: metrică → context → [unix time, avg, min, max] |
| Câmp | Descriere |
|---|---|
name |
Nume afișat, până la 100 de caractere. Obligatoriu la creare. |
services |
Numele serviciilor pe care agentul ar trebui să le urmărească, de exemplu ["nginx", "php8.4-fpm", "mariadb"]; până la 200. Serverul raportează ce a găsit sub discovered.services. |
thresholds |
Praguri de alertă: cpu_max (procent), load_max_per_cpu, mem_min_pavail (procent liber), fs_warn și fs_crit (procent folosit), inode_warn, agent_nodata_minutes, pe punct de montare sub filesystems, și expresiile regulate fs_types, fs_exclude, net_exclude. Valorile omise păstrează valorile implicite. |
Adaugă un server și citește comanda de instalare din răspuns:
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"
}
}
Urmărește trei servicii și alertează la 80 la sută utilizare a discului:
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}
}'
Incidente
Un incident este o cădere sau un avertisment al unui monitor sau server, de la started_at până la resolved_at. Fiecare incident poartă numărul alertei, același pe care îl arată e-mailul de alertă.
| Endpoint | Ce face |
|---|---|
GET /incidents |
Cele mai noi primele; filtre monitor_id, status (open sau closed), open=1 (căderi deschise fără anunțuri), from și to (date) |
GET /incidents/{id} |
Un incident cu cronologia lui: când a căzut și când s-a refăcut fiecare locație, și reparația care l-a rezolvat |
Incidente deschise:
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}
}
Câmpuri utile: subject_type (monitor sau server), severity (major, warning, info), cause (de exemplu unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations și, cât timp este deschis, failure_reason cu cele mai recente valori ale verificării.
Pagini de status
O pagină de status arată monitoarele alese publicului sau echipei tale, sub domeniul nostru sau sub al tău. Anunțurile comunică mentenanță sau explică un incident în curs.
| Endpoint | Ce face |
|---|---|
GET /status-pages |
Listare |
POST /status-pages |
Creare |
GET /status-pages/{id} |
O pagină cu monitoare, anunțuri și starea domeniilor ei |
PATCH /status-pages/{id} |
Modificare; monitors înlocuiește întreaga listă |
DELETE /status-pages/{id} |
Ștergere (204) |
POST /status-pages/{id}/notices |
Adăugarea unui anunț |
PUT /status-pages/{id}/notices/{notice} |
Modificarea unui anunț |
DELETE /status-pages/{id}/notices/{notice} |
Eliminarea unui anunț (204) |
| Câmp | Descriere |
|---|---|
slug |
Parte din adresă, 3–63 de caractere, litere mici, cifre și cratime; unic. Obligatoriu. |
title |
Titlul paginii. Obligatoriu. |
description |
Text scurt sub titlu, până la 2000 de caractere. |
logo_url |
Adresa HTTPS a unui logo. |
custom_domain |
Domeniu propriu, precum status.example.com; necesită un plan cu domenii proprii pentru paginile de status. |
is_public |
Publică (true) sau doar pentru utilizatorii autentificați. |
monitors |
Listă ordonată de {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name și group sunt opționale. |
Un anunț are kind (maintenance, info sau incident), title, body (opțional, până la 5000 de caractere), starts_at și un ends_at opțional.
Creează o pagină de status publică cu două monitoare:
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"}
]
}'
Anunță o fereastră de mentenanță:
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"
}'
Canale de notificare
Un canal de notificare este o cale de a ajunge la cineva: o adresă de e-mail, un chat Telegram, un webhook sau dispozitivele push ale unui utilizator. Un canal primește alertele tuturor monitoarelor din workspace sau doar ale monitoarelor din monitor_ids. Ce tipuri de canale include planul tău: GET /notification-channel-types.
| Endpoint | Ce face |
|---|---|
GET /notification-channels |
Listare |
POST /notification-channels |
Creare; pentru un webhook, secret-ul de semnare apare doar în acest răspuns |
GET /notification-channels/{id} |
Un canal |
PATCH /notification-channels/{id} |
Modificare; tipul nu se poate schimba |
DELETE /notification-channels/{id} |
Ștergere (204) |
POST /notification-channels/{id}/test |
Trimite o notificare de test (202); o adresă de e-mail neconfirmată primește în schimb din nou linkul de confirmare |
GET /notification-channel-types |
Tipuri de canale cu available și paid |
| Câmp | Descriere |
|---|---|
type |
email, telegram, webhook sau push. Obligatoriu, nu se mai schimbă. |
name |
Nume afișat. Obligatoriu. |
config |
Pe tip: {"email": "…"}, {"chat_id": "…"} sau {"url": "https://…"}. Push nu are nevoie de configurație. O adresă de e-mail nouă trebuie confirmată prin link înainte să plece alerte. |
monitor_ids |
UUID-urile monitoarelor pentru care este canalul; omite-l pentru toate monitoarele. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: nicio alertă în acel interval. |
escalation_delay_minutes |
Alertează acest canal doar când o cădere durează atât de mult (0–1440). |
notify_recovery |
Trimite și mesajul de revenire (true sau false). |
is_active |
Pornește sau oprește canalul fără să-l ștergi. |
Creează un canal webhook pentru două monitoare și păstrează secretul:
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-ul webhook-ului
Un canal webhook trimite prin POST fiecare alertă ca JSON către URL-ul tău, cu un timeout de 10 secunde și fără redirecționări. Ținta trebuie să fie o adresă publică.
Antete: X-Webhook-Timestamp (Unix time), X-Webhook-Signature (sha256= urmat de HMAC-SHA256 al <timestamp>.<body> cu secretul canalului drept cheie) și User-Agent: Uptime-Webhook/1.
event este down, recovered, paused sau test. Pentru o alertă de monitor, corpul conține monitor (id, name, target) și incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); pentru o alertă de server, server (id, name) și incident cu problem în loc de locații. subject este titlul alertei în limba canalului.
Corpul unei alerte 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"
}
Verifică semnătura înainte să te încrezi în corp: calculează HMAC-ul peste corpul brut exact așa cum a fost primit și compară-l în timp constant. Respinge marcajele de timp mai vechi de câteva minute.
Verificarea semnăturii într-un shell:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Sumarul dashboard-ului
GET /dashboard returnează numerele din spatele plăcilor din prezentarea generală: monitoare pe status (serverele se numără cu unitățile lor de plan), servere pe status și numărul de incidente deschise. Oricare dintre monitors:read, servers:read sau incidents:read îl deschide.
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
}
}
Întrebări frecvente
Ce plan include API-ul?
Tokenurile API vin cu planul Business și cu cele de deasupra. La planurile mai mici vezi secțiunea la Contul meu, estompată, cu un link de upgrade. Tot restul din Centoculus funcționează fără API.
Poate un singur token să facă tot ce poate contul meu?
Nu. Un token ajunge doar în zonele pentru care i-ai dat scope-uri și niciodată la facturare, membrii echipei, alte tokenuri, securitatea contului sau reparații. Acestea rămân în aplicație.
Există un sandbox?
Folosește un token doar cu scope-uri de citire ca să explorezi și creează monitoare de test în planul gratuit al unui al doilea cont. Monitoarele pe care le creezi se numără în planul tău ca cele create în aplicație.
Cum aduc alertele în propriul meu sistem?
Creează un canal webhook și verifică semnătura fiecărei livrări. Fiecare cădere, revenire și pauză ajunge la URL-ul tău în câteva secunde, cu monitorul, cauza și locațiile afectate ca JSON.
Se schimbă API-ul?
Versiunea este în adresă (/api/v1). La răspunsuri pot fi adăugate oricând câmpuri noi; într-o versiune câmpurile nu sunt eliminate sau redenumite. Citește ce ai nevoie și ignoră restul.
Ești gata să-ți automatizezi monitorizarea?
Tokenurile API sunt incluse în planul Business și în cele de deasupra. Compară planurile sau începe gratuit și treci la un plan mai mare când scripturile tale sunt gata.