CoreDash Uptime-API og MCP-værktøjer: monitors og tjek

Uptime-monitors via CoreDash API'et

Læs og rediger dine CoreDash-projekters uptime-monitors via REST med den API-nøgle, du allerede bruger til dine RUM-data. En AI-agent læser dem via MCP.

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

API-nøgler til uptime-monitors

Uptime-endpoints accepterer nøglerne fra CoreDash API'et og Agency API'et.

Opret en projektnøgle på siden Connect Your AI i dit projekts sidepanel: Giv den et navn, og klik på Generate API key. De samme nøgler findes i dine projektindstillinger under API Keys (MCP). Kun projektets ejere kan oprette dem. En masternøgle hentes fra siden Agency API i sidepanelet på agency-konti. Når et projekt er udløbet, får dets projektnøgle 401 på alle kald.

En gæst på et projekt kan kun læse dets monitors. At tilføje, ændre, flytte og slette dem kræver et projekt, du selv ejer.

OAuth-tokenet fra en AI-forbindelse som Claude (mcp_at_) kan kun læse. POST, PATCH og DELETE med det giver 403.

Uptime-endpoints

Origin-IP'en og headerværdierne er hemmelige. De returneres ved POST, PATCH og GET /api/uptime/monitors/:id. Listen og MCP-værktøjerne udelader origin_ip og viser alle headerværdier som ••••.

Monitor-objektet

Felterne summary og rum

Både listen og den enkelte monitor indeholder et summary: rounds_7d og down_rounds_7d tæller runderne de seneste 7 dage, uptime_7d er procentdelen af disse runder uden et down-tjek, og recent indeholder de seneste 48 runder, ældste først, hver med rundens værste udfald. En monitor uden tjek de seneste 7 dage har summary: null.

Den enkelte monitor indeholder også rum: p75 TTFB for dine reelle besøgende de seneste 7 dage, baseret på projektets RUM-data, til sammenligning med tjekkerens ttfb_ms. Værdien er null, så længe projektet ikke har nogen RUM-data.

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

I det rigtige svar indeholder recent 48 runder; dette eksempel viser de to seneste.

Tjek-objektet og dets udfald

Hvert 30. minut tjekker en runde alle monitors på skift fra to servere: scan1 ved :00, scan2 ved :30. En runde tjekker altid URL'en på samme måde, som besøgende tilgår den – via DNS og dit CDN (edge). Med en origin-IP tjekker den også din server direkte (origin). API'et har intet kald til at tjekke en monitor mellem runderne. Tjek gemmes i 30 dage.

Hvert tjek sender user-agenten CoreDash/1.0 (uptime; +https://www.coredash.app/bot). Ligger monitorens URL på dit projekts eget site (dets host, med eller uden www, eller et subdomæne), sender tjekket også headeren X-CoreDash-Bot med dit projekts hemmelige værdi fra fanen CoreDash bot token i dine projektindstillinger. En monitor på et hvilket som helst andet site får intet token. Ved et redirect følger tokenet reglen for de headers, du har angivet: Det sendes kun med, så længe dit redirect bliver på monitorens host. En af dine egne headers ved navn X-CoreDash-Bot fjernes. CoreDash-botsiden forklarer mere om begge dele.

Sådan får et tjek sit udfald

Det dårligste udfald blandt en rundes tjek afgør monitorens tilstand, fra værst til bedst: down, blocked, warn, up.

Monitorens tilstande

En monitor i et projekt, hvor abonnementet er udløbet, beholder sine indstillinger og sin seneste tilstand. Den tjekkes ikke igen, før projektet er betalt.

Tilføj, rediger og slet en monitor

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

Svaret er 201 med den nye monitor, inklusive origin-IP og headerværdier:

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

Send kun de felter, du ændrer. headers erstatter hele listen, så send alle headers, du vil beholde. Dette sætter en monitor på 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 }'

Med en masternøgle flytter project_id monitoren efter de samme regler som ved POST.

DELETE /api/uptime/monitors/:id

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

Handlingen kan ikke fortrydes. Vil du stoppe tjekkene og beholde historikken, sender du { "paused": true } med PATCH.

Fejl og begrænsninger i uptime-API'et

Fejl returneres som { "error": "..." } med en af disse statuskoder:

Begrænsninger: 25 monitors pr. projekt, 5 ekstra headers pr. monitor, 2100 tjek pr. GET på en enkelt monitor og 30 dages tjekhistorik.

Uptime MCP-værktøjer

CoreDash MCP-serveren på https://app.coredash.app/api/mcp har to uptime-værktøjer ved siden af RUM-værktøjerne, samt list_projects til de projekter, din nøgle har adgang til. Alle tre har kun læseadgang. Vil du oprette, ændre eller slette en monitor, bruger du appen eller REST-endpoints herover med en CoreDash API-nøgle. Værktøjerne kræver intet project_id: En projektnøgle læser sit eget projekt, mens en masternøgle eller en OAuth-forbindelse som Claude læser alle projekter, du ejer eller er inviteret til.

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

Svaret er JSON-RPC-wrapperen fra CoreDash API'et med resultatet som en JSON-streng i result.content[0].text. En ukendt monitor returnerer { "error": "Monitor not found" } dér, og result.isError er true.

Mere om uptime og CoreDash API'et

• Uptime-overvågning: Hvad CoreDash tjekker, og hvad du ser i appen.
• CoreDash API: Projektnøgler, JSON-RPC-formatet og RUM-værktøjerne.
• Agency API: Masternøgler og projekter via REST.
• CoreDash-botten: User-agenten, X-CoreDash-Bot-headeren og adresserne.
• Luk CoreDash igennem din firewall: Til en monitor, der melder Blocked.