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.
- Créez un jeton sous Mon compte → Jetons d’API dans l’application web ou mobile et choisissez ses scopes.
- Copiez le jeton tout de suite : il n’est affiché qu’une seule fois.
- 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.
| Scope | Autorise |
|---|---|
monitors:read | Lister 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:write | Créer, modifier, supprimer, mettre en pause et reprendre des moniteurs |
servers:read | Lister et afficher les serveurs et leurs métriques |
servers:write | Créer, modifier, supprimer, mettre en pause et reprendre des serveurs ; nouvelle commande d’installation de l’agent |
incidents:read | Lister et afficher les incidents, résumé du tableau de bord |
status-pages:read | Lister et afficher les pages de statut |
status-pages:write | Créer, modifier et supprimer des pages de statut et leurs annonces |
notifications:read | Lister et afficher les canaux de notification et leurs types |
notifications:write | Cré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 sousdataaveclinksetmeta. - 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
pageetper_page;metacontientcurrent_page,last_page,per_pageettotal. 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.
| Statut | Signification |
|---|---|
401 | Jeton manquant, invalide, expiré ou révoqué. |
402 | La surveillance est en pause car le solde prépayé est épuisé (clients de revendeurs) ; elle reprend après un rechargement. |
403 | Le 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é. |
404 | Introuvable, ou hors de votre espace de travail. |
409 | Conflit, 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. |
429 | Trop 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ès | Ce 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
| Champ | Description |
|---|---|
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ès | Ce 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ès | Ce 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] |
| Champ | Description |
|---|---|
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ès | Ce 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ès | Ce 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) |
| Champ | Description |
|---|---|
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ès | Ce 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 |
| Champ | Description |
|---|---|
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.