API d'uptime et outils MCP CoreDash : monitors et vérifications
Listez, ajoutez, modifiez et supprimez des monitors d'uptime avec votre clé API CoreDash, consultez leurs vérifications ou laissez un agent IA s'en charger via MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Authentification
Les endpoints d'uptime acceptent les mêmes tokens Bearer que le reste de l'API CoreDash :
- Clé API projet (
cdk_...) : donne accès aux monitors associés à ce projet RUM. Tout monitor créé avec cette clé est rattaché à ce projet. - Clé maître (
cdk_master_..., API Agency) : tous les monitors du compte, plus ceux liés aux projets que le compte peut ouvrir. - Token OAuth MCP : même scope qu'une clé projet.
Endpoints
| Méthode et chemin | Action |
|---|---|
GET /api/uptime/monitors | Tous les monitors avec leur état, dernière vérification, uptime sur 7 jours et résultat des 48 dernières vérifications. |
POST /api/uptime/monitors | Ajoute un monitor. Renvoie 201 et le monitor. La première vérification s'exécute dans la minute. |
GET /api/uptime/monitors/:id | Un monitor avec ses vérifications récentes, les plus récentes en premier. ?limit= jusqu'à 2100 (7 jours avec vérification de l'origine). |
PATCH /api/uptime/monitors/:id | Modifie les champs envoyés. paused: true interrompt les vérifications. |
DELETE /api/uptime/monitors/:id | Supprime le monitor et son historique de vérifications. |
POST /api/uptime/monitors/:id/check | Demande une vérification immédiate. Renvoie 202 ; le résultat arrive en une minute environ. |
Ajouter un monitor
| Champ | Description |
|---|---|
url | Obligatoire. Une URL complète en http ou https. |
name | Nom d'affichage. Par défaut : l'hôte de l'URL. |
project_id | Clé maître uniquement : associe le monitor à un projet RUM pour comparer le TTFB. |
origin_ip | IP publique du serveur. Ajoute la vérification de l'origine, qui contourne le DNS et le CDN. Une chaîne vide la supprime. |
headers | Jusqu'à 5 headers de requête, [{ "name", "value" }], pour une règle de pare-feu qui laisse passer le checker. |
expect_status | Le statut considéré comme up. Par défaut : 200. |
paused | PATCH uniquement. true interrompt les vérifications, false les relance. |
À quoi ressemble un monitor
state prend l'une de ces valeurs :
up: la dernière vérification a réussi.failing: la dernière vérification a échoué, la précédente avait réussi.down: deux vérifications consécutives ont échoué ; les deux serveurs ont donc constaté l'échec.blocked: une 403, une 429 ou un challenge Cloudflare. Voir laisser passer le checker.warn: tout autre statut que celui considéré comme up.pendingoupaused.
Une vérification en échec renvoie une error : dns, connect, connect_timeout, timeout (30 secondes), tls, redirects ou network. L'IP d'origine et les valeurs des headers ne sont renvoyées que par GET /api/uptime/monitors/:id. Les listes et les réponses MCP les masquent.
Outils MCP
Le serveur MCP CoreDash propose six outils d'uptime aux côtés des outils RUM. Avec une clé maître, ils n'ont pas besoin de project_id.
| Outil | Usage |
|---|---|
list_uptime_monitors | « Tout est up ? » |
get_uptime_monitor | « Le checkout a-t-il été down cette semaine, et depuis quand ? » Renvoie les vérifications récentes et l'uptime correspondant. |
create_uptime_monitor | « Surveille aussi notre page de connexion. » |
update_uptime_monitor | Modifier l'URL, l'IP d'origine ou les headers, ou mettre un monitor en pause. |
delete_uptime_monitor | Supprimer un monitor et son historique. |
check_uptime_now | « Vérifie à nouveau maintenant. » |
