CoreDash uptime-API og MCP-værktøjer: monitorer og tjek
Oplist, tilføj, ændr og slet uptime-monitorer med din CoreDash-API-nøgle, læs deres tjek, eller lad en AI-agent gøre det over MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Autentifikation
Uptime-endepunkterne bruger de samme Bearer-tokens som resten af CoreDash API'et:
- Projekt-API-nøgle (
cdk_...): har adgang til de monitorer, der er knyttet til det RUM-projekt. Opretter du en monitor med den, knyttes den til projektet. - Master-nøgle (
cdk_master_..., Agency API): alle monitorer på kontoen plus de monitorer, der er knyttet til projekter, kontoen kan åbne. - MCP OAuth-token: samme scope som en projekt-API-nøgle.
Endepunkter
| Metode og sti | Hvad det gør |
|---|---|
GET /api/uptime/monitors | Alle monitorer med deres tilstand, seneste tjek, oppetid over 7 dage og resultatet af de seneste 48 tjek. |
POST /api/uptime/monitors | Tilføjer en monitor. Returnerer 201 og monitoren. Det første tjek kører inden for et minut. |
GET /api/uptime/monitors/:id | Én monitor med dens seneste tjek, nyeste først. ?limit= op til 2100 (7 dage med et origin-tjek). |
PATCH /api/uptime/monitors/:id | Ændrer de felter, du sender. paused: true stopper tjekkene. |
DELETE /api/uptime/monitors/:id | Sletter monitoren og dens tjekhistorik. |
POST /api/uptime/monitors/:id/check | Beder om et tjek med det samme. Returnerer 202; resultatet lander inden for cirka et minut. |
Tilføj en monitor
| Felt | Betydning |
|---|---|
url | Påkrævet. En komplet http- eller https-URL. |
name | Visningsnavn. Standard: URL'ens host. |
project_id | Kun master-nøgle: knyt monitoren til et RUM-projekt til TTFB-sammenligningen. |
origin_ip | Din servers offentlige IP. Tilføjer origin-tjekket, som går uden om DNS og CDN'et. En tom streng fjerner det. |
headers | Op til 5 request-headers, [{ "name", "value" }], til en firewall-regel, der lukker tjekkeren igennem. |
expect_status | Den status, der tæller som oppe. Standard: 200. |
paused | Kun PATCH. true stopper tjekkene, false starter dem igen. |
Sådan ser en monitor ud
state er en af følgende:
up: det seneste tjek lykkedes.failing: det seneste tjek fejlede, det forrige lykkedes.down: to fejlede tjek i træk, så begge servere så det fejle.blocked: en 403, en 429 eller en Cloudflare-challenge. Se sådan lukker du tjekkeren igennem.warn: enhver anden status end den, der tæller som oppe.pendingellerpaused.
Et fejlet tjek har en error: dns, connect, connect_timeout, timeout (30 sekunder), tls, redirects eller network. Origin-IP'en og header-værdierne returneres kun af GET /api/uptime/monitors/:id. Lister og MCP-svar maskerer dem.
MCP-værktøjer
CoreDash MCP-serveren har seks uptime-værktøjer ved siden af RUM-værktøjerne. Med en master-nøgle behøver de ikke et project_id.
| Værktøj | Brug det til |
|---|---|
list_uptime_monitors | "Er alt oppe?" |
get_uptime_monitor | "Var checkout nede i denne uge, og siden hvornår?" Returnerer de seneste tjek og oppetiden for dem. |
create_uptime_monitor | "Overvåg også vores login-side." |
update_uptime_monitor | Skift URL'en, origin-IP'en eller headers, eller sæt en monitor på pause. |
delete_uptime_monitor | Fjern en monitor og dens historik. |
check_uptime_now | "Tjek igen nu." |