CoreDash-oppetids-API og MCP-verktøy: overvåkere og sjekker
List opp, legg til, endre og slett oppetidsovervåkere med CoreDash-API-nøkkelen din, les sjekkene deres, eller la en AI-agent gjøre det over MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Autentisering
Oppetidsendepunktene tar de samme Bearer-tokenene som resten av CoreDash-API-et:
- Prosjekt-API-nøkkel (
cdk_...): ser overvåkerne som er knyttet til det RUM-prosjektet. En overvåker du oppretter med den, knyttes til det prosjektet. - Masternøkkel (
cdk_master_..., Agency API): alle overvåkere på kontoen, pluss overvåkerne knyttet til prosjekter kontoen kan åpne. - MCP-OAuth-token: samme scope som en prosjekt-API-nøkkel.
Endepunkter
| Metode og sti | Hva den gjør |
|---|---|
GET /api/uptime/monitors | Alle overvåkere med tilstand, siste sjekk, oppetid over 7 dager og resultatet av de siste 48 sjekkene. |
POST /api/uptime/monitors | Legger til en overvåker. Returnerer 201 og overvåkeren. Den første sjekken kjøres innen et minutt. |
GET /api/uptime/monitors/:id | Én overvåker med de siste sjekkene, nyeste først. ?limit= opptil 2100 (7 dager med origin-sjekk). |
PATCH /api/uptime/monitors/:id | Endrer feltene du sender. paused: true stopper sjekkene. |
DELETE /api/uptime/monitors/:id | Sletter overvåkeren og sjekkhistorikken. |
POST /api/uptime/monitors/:id/check | Ber om en sjekk med en gang. Returnerer 202; resultatet er klart innen omtrent et minutt. |
Legg til en overvåker
| Felt | Betydning |
|---|---|
url | Påkrevd. En fullstendig http- eller https-URL. |
name | Visningsnavn. Standard: vertsnavnet i URL-en. |
project_id | Kun masternøkkel: knytt overvåkeren til et RUM-prosjekt, for TTFB-sammenligningen. |
origin_ip | Offentlig IP til serveren din. Legger til origin-sjekken, som går utenom DNS og CDN. Tom streng fjerner den. |
headers | Opptil 5 request-headere, [{ "name", "value" }], for en brannmurregel som slipper sjekkeren gjennom. |
expect_status | Statuskoden som regnes som oppe. Standard: 200. |
paused | Kun PATCH. true stopper sjekkene, false starter dem igjen. |
Slik ser en overvåker ut
state er en av disse:
up: siste sjekk var vellykket.failing: siste sjekk feilet, den forrige var vellykket.down: to feilede sjekker på rad, så begge serverne registrerte at den feilet.blocked: en 403, en 429 eller en Cloudflare-challenge. Se hvordan du slipper sjekkeren gjennom.warn: enhver annen status enn den som regnes som oppe.pendingellerpaused.
En feilet sjekk har en error: dns, connect, connect_timeout, timeout (30 sekunder), tls, redirects eller network. Origin-IP-en og header-verdiene returneres bare fra GET /api/uptime/monitors/:id. Lister og MCP-svar maskerer dem.
MCP-verktøy
CoreDash MCP-serveren har seks oppetidsverktøy ved siden av RUM-verktøyene. Med en masternøkkel trenger de ikke project_id.
| Verktøy | Bruk det til |
|---|---|
list_uptime_monitors | «Er alt oppe?» |
get_uptime_monitor | «Var checkouten nede denne uken, og fra når?» Returnerer de siste sjekkene og oppetiden for dem. |
create_uptime_monitor | «Overvåk innloggingssiden vår også.» |
update_uptime_monitor | Endre URL-en, origin-IP-en eller headere, eller sett en overvåker på pause. |
delete_uptime_monitor | Fjern en overvåker og historikken dens. |
check_uptime_now | «Sjekk den igjen nå.» |
