Une API peut être en ligne et pourtant en panne. Un répartiteur de charge répond, le code de statut est 200, et le corps indique que la connexion à la base de données a échoué. Votre application mobile, vos partenaires et votre propre frontend voient tous une erreur, alors qu’un simple contrôle de disponibilité ne voit rien d’anormal.
La surveillance d’API appelle vos endpoints à intervalles réguliers et vérifie à la fois qu’ils répondent et que la réponse est correcte. Dans Uptimecheck, elle utilise les mêmes moniteurs HTTP(S) que la surveillance de disponibilité des sites web, avec les options dont une API a besoin.
Ce que vous pouvez configurer
Méthode : GET, POST, PUT, PATCH, DELETE, HEAD ou OPTIONS.En-têtes : jusqu’à 20, comme une clé API, un en-tête Authorization ou un user agent personnalisé.Corps : envoyez une charge utile JSON pour tester une opération d’écriture.Statut attendu : des codes ou des plages, comme 200-299 ou 201.Contrôles JSON et d’en-têtes : jusqu’à 10 contrôles qui doivent tous être vérifiés, par exemple $.status égal à ok.Mot-clé : un texte que la réponse doit contenir ou ne doit pas contenir.Délai d’expiration et seuil de lenteur : échec au bout de 30 secondes maximum, et une alerte de lenteur quand les réponses restent au-dessus de votre seuil.
Quels endpoints surveiller en premier
Commencez par les requêtes qui rapportent de l’argent ou qui bloquent les utilisateurs. Pour une boutique en ligne, ce sont le panier, le paiement et le callback du prestataire de paiement. Pour un produit SaaS, c’est la connexion, le principal endpoint de lecture et tout webhook que vous recevez d’un prestataire de paiement. La checklist de surveillance d’API indique quoi couvrir et à quelle fréquence, et notre guide des endpoints de health check montre ce qu’un bon endpoint doit renvoyer.
Une configuration type pour lumenanalytics.io
GET /health toutes les minutes, avec un contrôle JSON vérifiant que $.status est égal à ok.POST /v1/events avec une petite charge utile de test et un en-tête de clé API.GET /v1/reports avec un en-tête Authorization et une alerte de lenteur à 1 500 ms.
Sachez quand un endpoint ralentit
Uptimecheck contrôle depuis Stockholm, Londres et New York, et confirme chaque échec depuis un second site avant d’ouvrir un incident, ce qui évite qu’une seule requête perdue ne réveille l’équipe. Les temps de réponse sont enregistrés pour chaque contrôle et décomposés en DNS, connexion, TLS, serveur et téléchargement : vous voyez ainsi que l’endpoint des rapports est passé de 90 ms à 2,4 s à 14 h 00, que le temps s’est envolé dans la phase serveur et que le health check est resté stable.
Quand une seule requête ne suffit pas
Beaucoup de problèmes d’API n’apparaissent que dans une séquence : se connecter, obtenir un jeton, l’utiliser. Un moniteur de parcours exécute jusqu’à 10 étapes dans l’ordre, enregistre une valeur comme un jeton ou un identifiant de commande à une étape et la réutilise à la suivante. Les secrets comme les mots de passe sont chiffrés et ne sont plus jamais affichés.
Alertes et automatisation
Quand un endpoint échoue, les alertes partent par e-mail, Slack, Microsoft Teams, Discord, Google Chat, Mattermost, Telegram, PagerDuty, ntfy, Pushover, webhooks et notifications push sur votre téléphone, sur toutes les offres. Les webhooks sont signés, pour que vos propres outils puissent vérifier leur provenance. Vous pouvez aussi gérer les moniteurs depuis le code : sur Professional et Business, l’API REST crée et met à jour des moniteurs depuis votre pipeline de déploiement, si bien qu’un nouvel endpoint a son moniteur le jour de sa mise en ligne.
Surveillez vos dépendances, pas seulement votre code
Votre API dépend d’autres services : un prestataire de paiement, un service d’e-mail, une plateforme d’hébergement. Quand l’un d’eux tombe, votre endpoint peut encore répondre alors que la fonctionnalité qui se trouve derrière est cassée. Ajoutez des moniteurs sur les endpoints qui les sollicitent, et suivez les pages de statut de fournisseurs comme Klarna, Shopify, Cloudflare et OpenAI grâce à la surveillance des services tiers. Vous pouvez alors dire à un client en quelques minutes si le problème vient de chez vous ou d’un fournisseur.
Sécurisez le trafic de test
Utilisez un compte de test ou une clé API dédiés aux requêtes de surveillance, et rendez les contrôles d’écriture idempotents, pour qu’un POST toutes les minutes ne remplisse pas votre base de données d’enregistrements de test. Marquez le trafic de surveillance avec un en-tête user agent personnalisé, pour l’exclure facilement de vos statistiques et de vos logs.
Pour les tâches en arrière-plan qui n’exposent pas d’endpoint, utilisez plutôt la surveillance des tâches cron.
Les offres commencent à 9 € par mois en facturation annuelle ou 12 € en facturation mensuelle, HT. Consultez toutes les limites sur la page des tarifs, ou démarrez un essai gratuit de 14 jours sans carte bancaire.