Cliquer dans un tableau de bord, ça va pour dix moniteurs. Avec une centaine de services, des dizaines de sites clients ou une infrastructure qui change chaque semaine, la surveillance doit vivre dans le code. L’API REST couvre les moniteurs, les fenêtres de maintenance et les mises à jour de statut, avec une documentation sur app.uptimecheck.com/docs/api ; un serveur MCP permet aux assistants IA de faire de même avec une clé d’API.
Endpoints
Tous les endpoints se trouvent sous https://app.uptimecheck.com/api/v1 :
/monitors : lister, créer, modifier et supprimer des moniteurs de tous types, les mettre en pause et les relancer, et lire leurs dernières vérifications./monitors/{id}/metrics, /page-speed et /email : métriques serveur, résultats Lighthouse et rapports d’authentification des e-mails./incidents : lister les incidents, lire leur chronologie et en acquitter un./maintenance : planifier, modifier, terminer ou annuler des fenêtres de maintenance, et lister, modifier ou arrêter les fenêtres récurrentes sous /maintenance-schedules. Un PATCH contenant uniquement les champs à modifier déplace une fenêtre, et les abonnés qui en avaient été informés reçoivent le nouvel horaire./status-pages : lister vos pages, et publier, compléter et supprimer des mises à jour de statut, avec un niveau d’impact par composant concerné./summary, /projects et /alert-channels : l’état de tout en un coup d’œil, et les identifiants à utiliser pour créer des moniteurs.
Créez un moniteur depuis votre pipeline
Authentifiez-vous avec une clé d’API dans l’en-tête Authorization et envoyez du 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}’
Lancez cette commande dans l’étape même qui déploie le service, et chaque nouvel endpoint est surveillé dès sa mise en ligne. La première vérification a lieu dans la minute. La référence complète, avec des exemples de requêtes et de réponses, se trouve dans la documentation de l’API.
Les assistants IA via MCP
Le serveur MCP à l’adresse https://app.uptimecheck.com/api/mcp permet à Claude, Cursor, Copilot et d’autres assistants de travailler avec votre surveillance, avec les mêmes clés d’API. Demandez un résumé de l’état, examinez un incident, testez une requête, créez un moniteur, mettez-en un en pause pendant un déploiement, lancez une fenêtre de maintenance ou publiez une mise à jour de statut. Les outils qui modifient quelque chose exigent une clé en lecture et écriture.
Usages courants
Agences
Intégrez un nouveau client en un seul script : ajoutez des moniteurs pour le site, le tunnel de paiement et l’API dans le projet du client, avec les bons canaux d’alerte. Pour la fin de contrat, c’est le même script à l’envers.
Équipes plateforme
Gardez les moniteurs synchronisés avec votre catalogue de services, et lancez une fenêtre de maintenance depuis votre script de déploiement pour que les redémarrages prévus n’ouvrent pas d’incident et ne pèsent pas sur la disponibilité. Un provider Terraform pour gérer les moniteurs en tant que code arrive bientôt.
Communication de statut
Publiez une mise à jour de statut depuis vos propres outils de gestion d’incidents, pour que la page de statut et ses abonnés soient informés au moment même où votre équipe l’est.
Les webhooks pour l’autre sens
L’API vous permet de piloter Uptimecheck. Les webhooks permettent à Uptimecheck de vous appeler : chaque panne et chaque rétablissement sont envoyés en JSON signé vers votre propre endpoint, prêts à être reliés à l’outil qui gère vos astreintes. Voir alertes et notifications.
Conseils pratiques
Stockez la clé d’API comme secret dans votre système de CI, jamais dans le dépôt.Utilisez une clé en lecture seule pour les tableaux de bord et le reporting, et une clé en lecture et écriture uniquement là où quelque chose doit changer.Rendez vos scripts idempotents : recherchez un moniteur par son nom ou sa cible avant de le créer, pour qu’une nouvelle exécution ne crée pas de doublons.Utilisez dans l’API le même schéma de nommage que dans votre infrastructure, pour relier facilement un moniteur au service qu’il surveille.
La plupart des équipes commencent par automatiser la partie fastidieuse, l’ajout de moniteurs pour les nouveaux sites clients ou services, puis étendent aux fenêtres de maintenance et aux mises à jour de statut.
L’accès à l’API et au MCP est inclus dans Professional et Business. Les offres démarrent à 9 € par mois en facturation annuelle ou 12 € en facturation mensuelle, HT ; comparez les offres sur la page des tarifs, ou démarrez un essai gratuit de 14 jours de Professional sans carte bancaire. Consultez la surveillance d’API pour surveiller votre propre API avec Uptimecheck.