Aller au contenu
Centoculus

API de monitoring de disponibilité

Tout ce que vous faites dans l’application, vous pouvez le faire via l’API REST : créer des moniteurs depuis votre pipeline de déploiement, intégrer disponibilité et temps de réponse à vos propres tableaux de bord, garder pages de statut et canaux d’alerte synchronisés. JSON en entrée, JSON en sortie, un seul jeton Bearer. Les jetons d’API sont disponibles à partir de l’offre Business.

Premiers pas

URL de base

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

Chaque requête porte deux en-têtes : Authorization: Bearer <token> et Accept: application/json. Les requêtes avec corps envoient du JSON avec Content-Type: application/json.

  1. Créez un jeton sous Mon compte → Jetons d’API dans l’application web ou mobile et choisissez ses scopes.
  2. Copiez le jeton tout de suite : il n’est affiché qu’une seule fois.
  3. Appelez GET /me. Cela fonctionne avec tous les jetons et vous indique à qui appartient le jeton.

Votre premier appel :

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

La réponse est votre utilisateur avec son rôle, sa langue et les espaces de travail accessibles au jeton (abrégé) :

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

Jetons et scopes

Un jeton a un nom, une expiration facultative (jusqu’à 730 jours) et les scopes qu’il peut utiliser. N’accordez que les scopes dont une intégration a besoin : un tableau de bord reçoit monitors:read et incidents:read, un script de déploiement monitors:write. Sur les offres inférieures à Business, la section est visible mais grisée.

ScopeAutorise
monitors:readLister et afficher les moniteurs, la disponibilité, la disponibilité quotidienne, les temps de réponse, les types de contrôle, les emplacements, le résumé du tableau de bord
monitors:writeCréer, modifier, supprimer, mettre en pause et reprendre des moniteurs
servers:readLister et afficher les serveurs et leurs métriques
servers:writeCréer, modifier, supprimer, mettre en pause et reprendre des serveurs ; nouvelle commande d’installation de l’agent
incidents:readLister et afficher les incidents, résumé du tableau de bord
status-pages:readLister et afficher les pages de statut
status-pages:writeCréer, modifier et supprimer des pages de statut et leurs annonces
notifications:readLister et afficher les canaux de notification et leurs types
notifications:writeCréer, modifier et supprimer des canaux (e-mail, Telegram, webhook, push), envoyer un test

GET /me fonctionne avec tous les jetons. La facturation, l’équipe, les jetons, la sécurité du compte et les réparations ne sont pas accessibles avec un jeton d’API et répondent 403, tout comme un appel sans le scope correspondant.

Révoquez un jeton au même endroit ; il cesse de fonctionner immédiatement.

Conventions

  • Les réponses sont en JSON. Un objet unique arrive sous data, une liste sous data avec links et meta.
  • Les moniteurs et les serveurs sont adressés par UUID ; les incidents, les pages de statut et les canaux de notification par un identifiant numérique.
  • Les heures sont au format ISO 8601 en UTC, par exemple 2026-11-15T08:30:00.000000Z.
  • Les listes sont paginées avec les paramètres de requête page et per_page ; meta contient current_page, last_page, per_page et total. Tailles de page par défaut : moniteurs 15 (max. 200), incidents 25 (max. 100), canaux de notification 50, serveurs 100, pages de statut 15.
  • Les comptes avec plusieurs espaces de travail (partenaires et revendeurs) transmettent customer_id à la création et peuvent s’en servir pour filtrer les listes. Les comptes clients l’omettent.
  • Il n’y a pas de quota général de requêtes. Quelques points d’accès sont limités, par exemple le renvoi d’une confirmation par e-mail (10 par minute) ; ils répondent 429 avec Retry-After. N’interrogez pas plus souvent que votre intervalle de contrôle ; pour des données en direct, utilisez un canal webhook.

Erreurs

Les erreurs sont en JSON avec un message. Les erreurs de validation ajoutent errors avec une liste de messages par champ.

StatutSignification
401Jeton manquant, invalide, expiré ou révoqué.
402La surveillance est en pause car le solde prépayé est épuisé (clients de revendeurs) ; elle reprend après un rechargement.
403Le jeton n’a pas le scope, le point d’accès est fermé aux jetons d’API, ou votre offre n’inclut pas la fonctionnalité.
404Introuvable, ou hors de votre espace de travail.
409Conflit, par exemple la confirmation d’une adresse e-mail déjà confirmée.
422Échec de la validation ; voir errors. Quand une limite de l’offre est atteinte, upgrade indique la fonctionnalité qu’une offre supérieure débloque.
429Trop de requêtes sur un point d’accès limité ; attendez le nombre de secondes indiqué par Retry-After.

Une erreur de validation :

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

Moniteurs

Un moniteur est un contrôle : un site web, un certificat SSL, un ping, un port TCP, un enregistrement DNS, un heartbeat cron ou la configuration e-mail d’un domaine. Types : http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types vous indique quels types, intervalles et emplacements votre offre inclut, ainsi que les valeurs par défaut de chaque type.

Point d’accèsCe qu’il fait
GET /monitors Lister ; filtres status, search, ids (séparés par des virgules), with_stats=1 ajoute la disponibilité et le dernier temps de réponse
POST /monitors Créer ; les contrôles démarrent en arrière-plan
GET /monitors/{id} Un moniteur avec ses emplacements et son incident ouvert
PATCH /monitors/{id} Modifier ; le type ne peut pas changer
DELETE /monitors/{id} Supprimer (204)
POST /monitors/{id}/pause Mettre en pause ; un incident ouvert est clos
POST /monitors/{id}/resume Reprendre
GET /check-types Types, valeurs par défaut et limites de votre offre
GET /locations Emplacements de contrôle actifs (code, name, country)

Champs à la création

ChampDescription
name Nom affiché, jusqu’à 255 caractères. Obligatoire.
type L’un des types ci-dessus. Obligatoire, non modifiable ensuite.
target URL, nom d’hôte, adresse IP ou domaine, selon le type. Obligatoire sauf pour heartbeat, qui vous fournit à la place une URL de ping.
interval_seconds Intervalle de contrôle. Le minimum dépend de votre offre ; GET /check-types le renvoie sous limits.min_interval_seconds.
locations Codes d’emplacement, par exemple ["eu", "sg"]. Le nombre d’emplacements autorisés dépend de votre offre.
primary_location Emplacement principal qui confirme les pannes en premier (Smart Verify).
confirm_locations Nombre d’emplacements qui doivent constater l’échec avant que vous soyez alerté (1–3). Configurable sur les offres supérieures.
confirm_checks Nombre de contrôles échoués consécutifs qui confirment une panne (1–3). Configurable sur les offres supérieures.
options Selon le type. Pour http : method (GET, HEAD, POST), expected_status (p. ex. 200-399 ou 200,301), keyword avec keyword_mode (present ou absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Les options omises prennent les valeurs par défaut de GET /check-types.

Créer un contrôle de site web avec un mot-clé :

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

La réponse (201) est le moniteur. provisioning.state passe à synced dès que les emplacements l’ont pris en charge, status de pending à up après le premier contrôle :

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

Valeurs de statut : pending, up, degraded, down, paused.

Mettre un moniteur en pause pendant un déploiement et le reprendre ensuite :

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"

Disponibilité et temps de réponse

La disponibilité est calculée à partir des pannes (incidents de gravité major) ; les avertissements, comme un certificat bientôt expiré, ne comptent pas. Pas encore contrôlé donne null, pas 100.

Point d’accèsCe qu’il fait
GET /monitors/{id}/uptime Disponibilité en pourcentage sur les dernières 24 heures, 7 jours et 30 jours
GET /monitors/{id}/daily-uptime Disponibilité par jour calendaire (UTC), days 1–90, 30 par défaut
GET /monitors/{id}/response-times Temps de réponse et disponibilité par emplacement, range 24h, 7d ou 30d ; points horaires, quotidiens pour 30d

Disponibilité :

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

Temps de réponse (abrégé) :

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

Serveurs

Un serveur est une machine équipée de l’agent, qui remonte CPU, mémoire, charge, disques, réseau et services. La création d’un serveur renvoie la commande d’installation à usage unique ; exécutez-la sur la machine et le serveur apparaît un instant plus tard.

Point d’accèsCe qu’il fait
GET /servers Lister ; filtre ids
POST /servers Créer ; la réponse contient install_command (Linux) et install_command_freebsd
GET /servers/{id} Un serveur avec inventaire, dernier instantané et seuils
PATCH /servers/{id} Renommer, choisir les services surveillés, définir les thresholds
DELETE /servers/{id} Supprimer (204) ; l’agent est retiré de la surveillance
POST /servers/{id}/pause Mettre en pause ; les incidents ouverts sont clos
POST /servers/{id}/resume Reprendre
POST /servers/{id}/install-token Nouvelle commande d’installation ; rotate_key=true émet aussi une nouvelle clé d’agent
GET /servers/{id}/metrics Séries de graphiques, range 24h, 7d ou 30d : métrique → contexte → [unix time, avg, min, max]
ChampDescription
name Nom affiché, jusqu’à 100 caractères. Obligatoire à la création.
services Noms des services que l’agent doit surveiller, par exemple ["nginx", "php8.4-fpm", "mariadb"] ; jusqu’à 200. Le serveur indique ce qu’il a trouvé sous discovered.services.
thresholds Seuils d’alerte : cpu_max (pourcentage), load_max_per_cpu, mem_min_pavail (pourcentage libre), fs_warn et fs_crit (pourcentage utilisé), inode_warn, agent_nodata_minutes, par point de montage sous filesystems, et les expressions régulières fs_types, fs_exclude, net_exclude. Les valeurs omises gardent les valeurs par défaut.

Ajouter un serveur et lire la commande d’installation dans la réponse :

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

Surveiller trois services et alerter à 80 pour cent d’utilisation du disque :

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

Incidents

Un incident est une panne ou un avertissement d’un moniteur ou d’un serveur, de started_at jusqu’à resolved_at. Chaque incident porte son numéro d’alerte, le même que celui de l’e-mail d’alerte.

Point d’accèsCe qu’il fait
GET /incidents Du plus récent au plus ancien ; filtres monitor_id, status (open ou closed), open=1 (pannes ouvertes sans annonces), from et to (dates)
GET /incidents/{id} Un incident avec sa chronologie : quand quel emplacement est tombé puis revenu, et la réparation qui l’a traité

Incidents ouverts :

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

Champs utiles : subject_type (monitor ou server), severity (major, warning, info), cause (par exemple unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations et, tant qu’il est ouvert, failure_reason avec les dernières valeurs du contrôle.

Pages de statut

Une page de statut présente des moniteurs choisis au public ou à votre équipe, sous notre domaine ou le vôtre. Les annonces signalent une maintenance ou expliquent un incident en cours.

Point d’accèsCe qu’il fait
GET /status-pages Lister
POST /status-pages Créer
GET /status-pages/{id} Une page avec moniteurs, annonces et état de ses domaines
PATCH /status-pages/{id} Modifier ; monitors remplace toute la liste
DELETE /status-pages/{id} Supprimer (204)
POST /status-pages/{id}/notices Ajouter une annonce
PUT /status-pages/{id}/notices/{notice} Modifier une annonce
DELETE /status-pages/{id}/notices/{notice} Retirer une annonce (204)
ChampDescription
slug Partie d’adresse, 3–63 caractères, lettres minuscules, chiffres et tirets ; unique. Obligatoire.
title Titre de la page. Obligatoire.
description Court texte sous le titre, jusqu’à 2000 caractères.
logo_url Adresse HTTPS d’un logo.
custom_domain Domaine personnel comme status.example.com ; nécessite une offre avec domaines de statut personnalisés.
is_public Publique (true) ou réservée aux utilisateurs connectés.
monitors Liste ordonnée de {"id": "<monitor UUID>", "display_name": "…", "group": "…"} ; display_name et group sont facultatifs.

Une annonce a kind (maintenance, info ou incident), title, body (facultatif, jusqu’à 5000 caractères), starts_at et un ends_at facultatif.

Créer une page de statut publique avec deux moniteurs :

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

Annoncer une fenêtre de maintenance :

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

Canaux de notification

Un canal de notification est une façon de joindre quelqu’un : une adresse e-mail, une discussion Telegram, un webhook ou les appareils push d’un utilisateur. Un canal reçoit les alertes de tous les moniteurs de l’espace de travail, ou seulement celles des moniteurs listés dans monitor_ids. Les types de canaux inclus dans votre offre : GET /notification-channel-types.

Point d’accèsCe qu’il fait
GET /notification-channels Lister
POST /notification-channels Créer ; pour un webhook, le secret de signature figure uniquement dans cette réponse
GET /notification-channels/{id} Un canal
PATCH /notification-channels/{id} Modifier ; le type ne peut pas changer
DELETE /notification-channels/{id} Supprimer (204)
POST /notification-channels/{id}/test Envoyer une notification de test (202) ; une adresse e-mail non confirmée reçoit à la place son lien de confirmation
GET /notification-channel-types Types de canaux avec available et paid
ChampDescription
type email, telegram, webhook ou push. Obligatoire, non modifiable ensuite.
name Nom affiché. Obligatoire.
config Selon le type : {"email": "…"}, {"chat_id": "…"} ou {"url": "https://…"}. Push n’a pas besoin de configuration. Une nouvelle adresse e-mail doit être confirmée par lien avant l’envoi des alertes.
monitor_ids UUID des moniteurs concernés par ce canal ; omettez-le pour tous les moniteurs.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"} : aucune alerte pendant cette plage.
escalation_delay_minutes N’alerter ce canal que si une panne dure aussi longtemps (0–1440).
notify_recovery Envoyer aussi la fin d’alerte (true ou false).
is_active Activer ou désactiver le canal sans le supprimer.

Créer un canal webhook pour deux moniteurs et conserver le 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"
  }
}

Charge utile du webhook

Un canal webhook envoie chaque alerte en JSON par POST à votre URL, avec un délai d’expiration de 10 secondes et sans redirections. La cible doit être une adresse publique.

En-têtes : X-Webhook-Timestamp (heure Unix), X-Webhook-Signature (sha256= suivi du HMAC-SHA256 de <timestamp>.<body> avec le secret du canal comme clé) et User-Agent: Uptime-Webhook/1.

event vaut down, recovered, paused ou test. Pour une alerte de moniteur, le corps contient monitor (id, name, target) et incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations) ; pour une alerte de serveur server (id, name) et incident avec problem au lieu des emplacements. subject est le titre de l’alerte dans la langue du canal.

Corps d’une alerte de panne :

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

Vérifiez la signature avant de faire confiance au corps : calculez le HMAC sur le corps brut exactement comme reçu et comparez-le en temps constant. Rejetez les horodatages vieux de plus de quelques minutes.

Vérifier la signature dans un shell :

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

Résumé du tableau de bord

GET /dashboard renvoie les chiffres derrière les tuiles de la vue d’ensemble : moniteurs par statut (les serveurs comptent avec leurs unités d’offre), serveurs par statut et nombre d’incidents ouverts. Un seul des scopes monitors:read, servers:read ou incidents:read suffit à y accéder.

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

Questions fréquentes

Quelle offre inclut l’API ?

Les jetons d’API sont disponibles à partir de l’offre Business. Sur les offres plus petites, la section apparaît grisée sous Mon compte, avec un lien de mise à niveau. Tout le reste de Centoculus fonctionne sans l’API.

Un jeton peut-il tout faire comme mon compte ?

Non. Un jeton n’atteint que les domaines pour lesquels vous lui avez donné des scopes, et jamais la facturation, les membres de l’équipe, les autres jetons, la sécurité du compte ni les réparations. Cela reste dans l’application.

Existe-t-il un bac à sable ?

Pour explorer, utilisez un jeton avec des scopes en lecture seule et créez des moniteurs de test sur l’offre gratuite d’un second compte. Les moniteurs que vous créez comptent dans votre offre comme ceux créés dans l’application.

Comment recevoir les alertes dans mon propre système ?

Créez un canal webhook et vérifiez la signature de chaque envoi. Chaque panne, rétablissement et pause atteint votre URL en quelques secondes, avec le moniteur, la cause et les emplacements concernés en JSON.

L’API change-t-elle ?

La version figure dans l’adresse (/api/v1). De nouveaux champs peuvent être ajoutés aux réponses à tout moment ; au sein d’une version, aucun champ n’est supprimé ni renommé. Lisez ce dont vous avez besoin et ignorez le reste.

Prêt à automatiser votre monitoring ?

Les jetons d’API sont inclus à partir de l’offre Business. Comparez les offres, ou commencez gratuitement et passez à l’offre supérieure quand vos scripts sont prêts.