Door een dashboard klikken gaat prima voor tien monitors. Voor honderd services, tientallen klantsites of infrastructuur die elke week verandert, moet monitoring in code leven. De REST API dekt monitors, onderhoudsvensters en statusupdates, gedocumenteerd op app.uptimecheck.com/docs/api; met een MCP-server doen AI-assistenten hetzelfde met een API-sleutel.
Endpoints
Elk endpoint staat onder https://app.uptimecheck.com/api/v1:
/monitors: monitors van elk type opvragen, aanmaken, bijwerken en verwijderen, pauzeren en hervatten, en hun laatste checks uitlezen./monitors/{id}/metrics, /page-speed en /email: servermetrics, Lighthouse-resultaten en rapporten over e-mailauthenticatie./incidents: incidenten opvragen, de tijdlijn uitlezen en een incident bevestigen./maintenance: onderhoudsvensters plannen, wijzigen, beëindigen of annuleren, en terugkerende vensters opvragen, wijzigen of stoppen onder /maintenance-schedules. Een PATCH met alleen de velden die veranderen verplaatst een venster, en abonnees die erover waren geïnformeerd krijgen de nieuwe tijd./status-pages: je pagina’s opvragen, en statusupdates erop plaatsen, aanvullen en verwijderen, met een impact per getroffen component./summary, /projects en /alert-channels: de status van alles in één oogopslag, en de ID’s die je nodig hebt om monitors aan te maken.
Een monitor aanmaken vanuit je pipeline
Authenticeer met een API-sleutel in de Authorization-header en stuur JSON:
curl https://app.uptimecheck.com/api/v1/monitors -H “Authorization: Bearer uc_…” -H “Content-Type: application/json” -d ‘{“type”:”http”,”name”:”Checkout”,”target”:”https://northwind.shop/checkout”,”intervalSeconds”:60}’
Draai het in dezelfde stap die de service uitrolt, en elk nieuw endpoint wordt gemonitord zodra het live gaat. De eerste check draait binnen een minuut. De volledige referentie, met voorbeelden van requests en responses, staat in de API-documentatie.
AI-assistenten via MCP
Met de MCP-server op https://app.uptimecheck.com/api/mcp werken Claude, Cursor, Copilot en andere assistenten met je monitoring, met dezelfde API-sleutels. Vraag om een statusoverzicht, zoek een incident uit, test een request, maak een monitor aan, pauzeer er een tijdens een deploy, start een onderhoudsvenster of plaats een statusupdate. Tools die iets wijzigen hebben een sleutel met lees- en schrijfrechten nodig.
Veelgebruikte toepassingen
Bureaus
Een nieuwe klant onboarden in één script: voeg monitors toe voor de site, de checkout en de API in het project van de klant, met de juiste meldingskanalen. Offboarden is hetzelfde script in omgekeerde richting.
Platformteams
Houd monitors gelijk met je servicecatalogus, en start een onderhoudsvenster vanuit je deployscript, zodat geplande herstarts geen incidenten openen en geen uptime kosten. Een Terraform-provider voor monitors als code komt binnenkort.
Statuscommunicatie
Plaats een statusupdate vanuit je eigen incidenttooling, zodat de statuspagina en haar abonnees het horen op het moment dat je team het hoort.
Webhooks voor de andere richting
Met de API beheer je Uptimecheck. Met webhooks roept Uptimecheck jou aan: elke storing en elk herstel wordt als ondertekende JSON naar je eigen endpoint gestuurd, klaar om te koppelen aan alles waarop je on-call-proces draait. Zie meldingen en notificaties.
Praktische tips
Bewaar de API-sleutel als secret in je CI-systeem, nooit in de repository.Gebruik een alleen-lezen sleutel voor dashboards en rapportages, en een sleutel met lees- en schrijfrechten alleen waar iets moet veranderen.Maak scripts idempotent: zoek een monitor op naam of doel op voordat je hem aanmaakt, zodat een tweede run geen duplicaten oplevert.Gebruik in de API dezelfde naamgeving als in je infrastructuur, zodat een monitor makkelijk terug te voeren is op de service die hij bewaakt.
De meeste teams beginnen met het saaie deel te scripten, monitors toevoegen voor nieuwe klantsites of services, en breiden van daaruit uit naar onderhoudsvensters en statusupdates.
Toegang tot de API en MCP zit in Professional en Business. Abonnementen beginnen bij € 9 per maand bij jaarlijkse betaling of € 12 bij maandelijkse betaling, excl. btw; vergelijk abonnementen op de prijspagina, of start een gratis proefperiode van 14 dagen van Professional zonder creditcard. Zie API-monitoring om je eigen API met Uptimecheck te monitoren.