CoreDash Uptime API ja MCP-työkalut: monitorit ja tarkistukset
Listaa, lisää, muuta ja poista uptime-monitoreja CoreDashin API-avaimellasi, lue niiden tarkistukset tai anna AI-agentin hoitaa se MCP:n kautta.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Autentikointi
Uptime-endpointit käyttävät samoja Bearer-tokeneita kuin muukin CoreDash API:
- Projektin API-avain (
cdk_...): näkee kyseiseen RUM-projektiin liitetyt monitorit. Sillä luomasi monitori liitetään kyseiseen projektiin. - Master-avain (
cdk_master_..., Agency API): tilin kaikki monitorit sekä monitorit niistä projekteista, jotka tilillä voi avata. - MCP OAuth -token: sama scope kuin projektin API-avaimella.
Endpointit
| Metodi ja polku | Mitä se tekee |
|---|---|
GET /api/uptime/monitors | Kaikki monitorit sekä niiden tila, viimeisin tarkistus, 7 päivän uptime ja 48 viimeisimmän tarkistuksen tulos. |
POST /api/uptime/monitors | Lisää monitorin. Palauttaa 201 ja monitorin. Ensimmäinen tarkistus ajetaan minuutin kuluessa. |
GET /api/uptime/monitors/:id | Yksittäinen monitori ja sen viimeisimmät tarkistukset, uusin ensin. ?limit= enintään 2100 (7 päivää origin-tarkistuksella). |
PATCH /api/uptime/monitors/:id | Päivittää lähettämäsi kentät. paused: true pysäyttää tarkistukset. |
DELETE /api/uptime/monitors/:id | Poistaa monitorin ja sen tarkistushistorian. |
POST /api/uptime/monitors/:id/check | Pyytää tarkistuksen heti. Palauttaa 202; tulos saapuu noin minuutissa. |
Lisää monitori
| Kenttä | Merkitys |
|---|---|
url | Pakollinen. Täydellinen http- tai https-URL. |
name | Näyttönimi. Oletus: URL:n host. |
project_id | Vain master-avaimella: liitä monitori RUM-projektiin TTFB-vertailua varten. |
origin_ip | Palvelimesi julkinen IP-osoite. Lisää origin-tarkistuksen, joka ohittaa DNS:n ja CDN:n. Tyhjä merkkijono poistaa sen. |
headers | Enintään 5 request-headeria, [{ "name", "value" }], palomuurisääntöä varten, joka päästää tarkistimen läpi. |
expect_status | Tilakoodi, joka katsotaan toimivaksi. Oletus 200. |
paused | Vain PATCH. true pysäyttää tarkistukset, false käynnistää ne uudelleen. |
Miltä monitori näyttää
state on yksi seuraavista:
up: viimeisin tarkistus meni läpi.failing: viimeisin tarkistus epäonnistui, sitä edellinen meni läpi.down: kaksi peräkkäistä epäonnistunutta tarkistusta, eli molemmat palvelimet havaitsivat sen epäonnistuneen.blocked: 403, 429 tai Cloudflare-haaste. Katso tarkistimen päästäminen läpi.warn: mikä tahansa muu tilakoodi kuin se, joka katsotaan toimivaksi.pendingtaipaused.
Epäonnistuneella tarkistuksella on error: dns, connect, connect_timeout, timeout (30 sekuntia), tls, redirects tai network. Origin-IP ja headerien arvot palautetaan vain kutsusta GET /api/uptime/monitors/:id. Listaukset ja MCP-vastaukset maskaavat ne.
MCP-työkalut
CoreDashin MCP-palvelimessa on kuusi uptime-työkalua RUM-työkalujen rinnalla. Master-avaimella ne eivät tarvitse parametria project_id.
| Työkalu | Käyttötarkoitus |
|---|---|
list_uptime_monitors | "Onko kaikki pystyssä?" |
get_uptime_monitor | "Oliko kassa alhaalla tällä viikolla ja mistä lähtien?" Palauttaa viimeisimmät tarkistukset ja niiden aikaisen uptimen. |
create_uptime_monitor | "Valvo myös kirjautumissivua." |
update_uptime_monitor | Muuta URL-osoitetta, origin-IP:tä tai headereita, tai aseta monitori tauolle. |
delete_uptime_monitor | Poista monitori ja sen historia. |
check_uptime_now | "Tarkista se nyt uudelleen." |
