API d'uptime et outils MCP CoreDash : moniteurs et checks

Moniteurs d'uptime via l'API CoreDash

Consultez et modifiez les moniteurs d'uptime de vos projets CoreDash en REST, avec la clé API que vous utilisez déjà pour vos données RUM. Un agent IA les lit via MCP.

curl https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_your_key"

Clés API pour les moniteurs d'uptime

Les endpoints d'uptime acceptent les clés de l'API CoreDash et de l'API Agency.

Créez une clé de projet sur la page Connect Your AI dans la barre latérale du projet : donnez-lui un nom et cliquez sur « Generate API key ». Ces mêmes clés figurent dans les paramètres du projet sous « API Keys (MCP) ». Seuls les propriétaires du projet peuvent les créer. Une clé maître s'obtient sur la page Agency API de la barre latérale, pour les comptes agence. Lorsqu'un projet a expiré, sa clé de projet reçoit une 401 à chaque appel.

Un invité sur un projet peut lire ses moniteurs. Pour en ajouter, en modifier, en déplacer ou en supprimer, vous devez posséder le projet.

Le token OAuth d'une connexion IA comme Claude (mcp_at_) fonctionne uniquement en lecture. Tout appel POST, PATCH ou DELETE avec ce token reçoit une 403.

Endpoints d'uptime

L'IP d'origine et les valeurs d'en-tête sont secrètes. Elles sont renvoyées par POST, PATCH et GET /api/uptime/monitors/:id. La liste et les outils MCP omettent origin_ip et affichent chaque valeur d'en-tête sous la forme ••••.

L'objet moniteur

Les champs summary et rum

La liste comme le moniteur individuel contiennent un summary : rounds_7d et down_rounds_7d comptent les rounds des 7 derniers jours, uptime_7d indique le pourcentage de ces rounds sans aucun check down, et recent contient les 48 derniers rounds, du plus ancien au plus récent, avec à chaque fois le pire résultat du round. Un moniteur sans aucun check au cours des 7 derniers jours renvoie summary: null.

Le moniteur individuel inclut aussi rum : le TTFB au p75 constaté par vos vrais visiteurs au cours des 7 derniers jours, issu des données RUM du projet, pour le comparer au ttfb_ms de la sonde. Ce champ vaut null tant que le projet n'a pas de données RUM.

GET /api/uptime/monitors/:id

curl "https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16?limit=2" \
  -H "Authorization: Bearer cdk_your_key"

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "up",
    "last_check_at": "2026-10-20T08:00:09.000Z",
    "last_up_at": "2026-10-20T08:00:09.000Z",
    "down_since": null,
    "last_down": { "from": "2026-10-18T19:00:11.000Z", "to": "2026-10-18T20:00:10.000Z" },
    "check_requested_at": null,
    "last": {
      "edge": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
      "origin": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null },
      "origin_is_cdn": false
    },
    "cert_expires": "2027-01-02T23:59:59.000Z",
    "created_at": "2026-10-06T09:12:41.000Z"
  },
  "summary": {
    "rounds_7d": 336,
    "down_rounds_7d": 2,
    "uptime_7d": 99.4,
    "recent": [
      { "at": "2026-10-20T07:30:10.000Z", "outcome": "up" },
      { "at": "2026-10-20T08:00:09.000Z", "outcome": "up" }
    ]
  },
  "checks": [
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null }
  ],
  "rum": { "ttfb_p75": 1920, "rating": "poor", "period": "last 7 days" }
}

Dans la réponse réelle, recent contient 48 rounds ; cet exemple montre les deux derniers.

L'objet check et ses résultats

Toutes les 30 minutes, un round vérifie chaque moniteur à tour de rôle depuis deux serveurs : scan1 à :00, scan2 à :30. Un round vérifie toujours l'URL telle que les visiteurs y accèdent, via le DNS et votre CDN (edge). Si une IP d'origine est configurée, il teste aussi directement votre serveur (origin). L'API ne propose aucun appel pour vérifier un moniteur entre deux rounds. Les checks sont conservés 30 jours.

Chaque check envoie le user agent CoreDash/1.0 (uptime; +https://www.coredash.app/bot). Lorsque l'URL du moniteur se trouve sur le site propre de votre projet (son hôte, avec ou sans www, ou un sous-domaine), le check envoie aussi l'en-tête X-CoreDash-Bot contenant la valeur secrète de votre projet, disponible dans l'onglet CoreDash bot token des paramètres du projet. Un moniteur pointant vers tout autre site ne reçoit aucun token. En cas de redirection, le token suit la même règle que les headers configurés : il n'est transmis que si la redirection reste sur l'hôte du moniteur. Si vous définissez votre propre en-tête nommé X-CoreDash-Bot, il est supprimé. La page sur le bot CoreDash donne plus de détails sur ces deux points.

Comment un check obtient son résultat

Le pire résultat parmi les checks d'un round détermine l'état du moniteur, du pire au meilleur : down, blocked, warn, up.

États d'un moniteur

Un moniteur lié à un projet dont l'abonnement a pris fin conserve sa configuration et son dernier état. Il n'est plus vérifié tant que le projet n'est pas payé à nouveau.

Ajouter, modifier et supprimer un moniteur

POST /api/uptime/monitors

curl -X POST https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_master_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/checkout/",
    "name": "Checkout",
    "project_id": "655f1f77bcf86cd799439011",
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "expect_status": 200
  }'

La réponse renvoie un code 201 avec le nouveau moniteur, incluant l'IP d'origine et les valeurs d'en-tête :

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "pending",
    "last_check_at": null,
    "last_up_at": null,
    "down_since": null,
    "last_down": null,
    "check_requested_at": "2026-10-20T09:12:41.000Z",
    "last": {},
    "cert_expires": null,
    "created_at": "2026-10-20T09:12:41.000Z"
  }
}

PATCH /api/uptime/monitors/:id

Envoyez uniquement les champs à modifier. headers remplace la liste complète, transmettez donc chaque en-tête à conserver. Pour mettre un moniteur en pause :

curl -X PATCH https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "paused": true }'

Avec une clé maître, project_id déplace le moniteur selon les mêmes règles que pour POST.

DELETE /api/uptime/monitors/:id

curl -X DELETE https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key"

Cette action est irréversible. Pour arrêter les checks tout en conservant l'historique, envoyez { "paused": true } avec PATCH.

Erreurs et limites de l'API d'uptime

Les erreurs sont renvoyées sous la forme { "error": "..." } avec l'un de ces statuts :

Limites : 25 moniteurs par projet, 5 en-têtes supplémentaires par moniteur, 2100 checks par GET sur un moniteur, et 30 jours d'historique des checks.

Outils MCP d'uptime

Le serveur MCP CoreDash à l'adresse https://app.coredash.app/api/mcp intègre deux outils d'uptime aux côtés des outils RUM, plus list_projects pour les projets accessibles avec votre clé. Ces trois outils fonctionnent uniquement en lecture. Pour ajouter, modifier ou supprimer un moniteur, utilisez l'application ou les endpoints REST ci-dessus avec une clé API CoreDash. Ces outils n'exigent aucun project_id : une clé de projet lit son propre projet, tandis qu'une clé maître ou une connexion OAuth comme Claude lit tous les projets que vous possédez ou auxquels vous êtes invité.

curl -X POST https://app.coredash.app/api/mcp \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_uptime_monitor",
      "arguments": { "monitor_id": "6ad68c7a844fad80b752fd16", "limit": 48 }
    }
  }'

La réponse est l'enveloppe JSON-RPC de l'API CoreDash, avec le résultat sous forme de chaîne JSON dans result.content[0].text. Un moniteur inconnu renvoie { "error": "Monitor not found" } à cet emplacement, et result.isError vaut true.

En savoir plus sur l'uptime et l'API CoreDash

• Monitoring d'uptime : ce que CoreDash vérifie et ce qui s'affiche dans l'application.
• API CoreDash : clés de projet, format JSON-RPC et outils RUM.
• API Agency : clés maîtres et projets via REST.
• Bot CoreDash : user agent, en-tête X-CoreDash-Bot et adresses IP.
• Autoriser CoreDash dans votre pare-feu : pour un moniteur qui indique Bloqué.