Treci la conținut
Centoculus

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.

  1. Creează un token la Contul meu → Tokenuri API în aplicația web sau în aplicația de telefon și alege scope-urile lui.
  2. Copiază tokenul imediat; este afișat o singură dată.
  3. 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ă.

ScopePermite
monitors:readListarea și afișarea monitoarelor, uptime, uptime zilnic, timpi de răspuns, tipuri de verificări, locații, sumarul dashboard-ului
monitors:writeCrearea, modificarea, ștergerea, punerea în pauză și reluarea monitoarelor
servers:readListarea și afișarea serverelor și a metricilor lor
servers:writeCrearea, modificarea, ștergerea, punerea în pauză și reluarea serverelor; comandă nouă de instalare pentru agent
incidents:readListarea și afișarea incidentelor, sumarul dashboard-ului
status-pages:readListarea și afișarea paginilor de status
status-pages:writeCrearea, modificarea și ștergerea paginilor de status și a anunțurilor lor
notifications:readListarea și afișarea canalelor de notificare și a tipurilor de canale
notifications:writeCrearea, 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 sub data împreună cu links și meta.
  • 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 și per_page; meta conține current_page, last_page, per_page și total. 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_id câ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.

StatusSemnificație
401Token lipsă, invalid, expirat sau revocat.
402Monitorizarea este în pauză pentru că soldul prepaid s-a epuizat (clienții revânzătorilor); se reia după reîncărcare.
403Tokenului îi lipsește scope-ul, endpoint-ul este închis pentru tokenurile API sau planul tău nu include funcția.
404Negăsit sau în afara workspace-ului tău.
409Conflict, de exemplu confirmarea unei adrese de e-mail deja confirmate.
422Validarea 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.
429Prea 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.

EndpointCe 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âmpDescriere
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.

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

EndpointCe 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âmpDescriere
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ă.

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

EndpointCe 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âmpDescriere
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.

EndpointCe 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âmpDescriere
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.