Eine API kann erreichbar und trotzdem kaputt sein. Ein Load Balancer antwortet, der Statuscode ist 200, und im Body steht, dass die Datenbankverbindung fehlgeschlagen ist. Ihre mobile App, Ihre Partner und Ihr eigenes Frontend sehen einen Fehler, und ein einfacher Uptime-Check sieht nichts.
API-Monitoring ruft Ihre Endpunkte nach Zeitplan auf und prüft, ob sie antworten und ob die Antwort stimmt. In Uptimecheck nutzt es dieselben HTTP(S)-Monitore wie das Website-Uptime-Monitoring, mit den Optionen, die eine API braucht.
Was Sie konfigurieren können
Methode: GET, POST, PUT, PATCH, DELETE, HEAD oder OPTIONS.Header: bis zu 20, etwa ein API-Schlüssel, ein Authorization-Header oder ein eigener User-Agent.Body: Senden Sie eine JSON-Payload, um einen Schreibpfad zu testen.Erwarteter Status: Codes oder Bereiche wie 200-299 oder 201.JSON- und Header-Prüfungen: bis zu 10 Prüfungen, die alle erfüllt sein müssen, etwa $.status gleich ok.Keyword: Text, den die Antwort enthalten oder nicht enthalten darf.Timeout und Langsam-Grenze: Fehler nach bis zu 30 Sekunden und ein Alarm wegen Langsamkeit, wenn Antworten dauerhaft über Ihrer Grenze liegen.
Welche Endpunkte Sie zuerst überwachen sollten
Beginnen Sie mit den Anfragen, die Umsatz bringen oder Nutzer blockieren. Bei einem Onlineshop sind das Warenkorb, Checkout und der Payment-Callback. Bei einem SaaS-Produkt sind es Login, der wichtigste Lese-Endpunkt und jeder Webhook, den Sie von einem Zahlungsanbieter erhalten. Die Checkliste für API-Monitoring zeigt, was Sie abdecken sollten und wie oft, und unser Leitfaden zu Health-Check-Endpunkten zeigt, was ein guter Endpunkt zurückgibt.
Ein typisches Setup für lumenanalytics.io
GET /health jede Minute, mit einer JSON-Prüfung, dass $.status gleich ok ist.POST /v1/events mit einer kleinen Test-Payload und einem API-Schlüssel im Header.GET /v1/reports mit einem Authorization-Header und einem Alarm wegen Langsamkeit ab 1.500 ms.
Erkennen, wenn ein Endpunkt langsamer wird
Uptimecheck prüft aus Stockholm, London und New York und bestätigt jeden Fehler von einem zweiten Standort, bevor ein Vorfall eröffnet wird. So weckt eine einzelne verlorene Anfrage nicht das ganze Team. Antwortzeiten werden pro Check gespeichert und in DNS, Verbindungsaufbau, TLS, Server und Download aufgeteilt. Sie sehen also, dass der Reports-Endpunkt um 14:00 von 90 ms auf 2,4 s gesprungen ist, dass die Zeit in der Serverphase verloren ging und dass der Health-Check unverändert blieb.
Wenn eine Anfrage nicht reicht
Viele API-Probleme zeigen sich erst in einer Abfolge: einloggen, Token holen, Token verwenden. Ein Ablauf-Monitor führt bis zu 10 Schritte nacheinander aus, speichert einen Wert wie ein Token oder eine Bestell-ID aus einem Schritt und verwendet ihn im nächsten. Geheimnisse wie Passwörter werden verschlüsselt und nie wieder angezeigt.
Alarme und Automatisierung
Fällt ein Endpunkt aus, werden in jedem Tarif Alarme per E-Mail, Slack, Microsoft Teams, Discord, Google Chat, Mattermost, Telegram, PagerDuty, ntfy, Pushover, Webhooks und Push-Benachrichtigungen auf Ihr Smartphone verschickt. Webhooks sind signiert, sodass Ihre eigenen Tools prüfen können, woher sie stammen. Monitore lassen sich auch per Code verwalten: In Professional und Business legt die REST API Monitore aus Ihrer Deploy-Pipeline an und aktualisiert sie, sodass ein neuer Endpunkt am Tag seines Releases überwacht wird.
Abhängigkeiten überwachen, nicht nur den eigenen Code
Ihre API hängt von anderen ab: einem Zahlungsanbieter, einem E-Mail-Dienst, einer Hosting-Plattform. Fällt einer davon aus, antwortet Ihr Endpunkt vielleicht noch, während die Funktion dahinter nicht mehr geht. Legen Sie Monitore für die Endpunkte an, die diese Dienste nutzen, und verfolgen Sie die Statusseiten von Anbietern wie Klarna, Shopify, Cloudflare und OpenAI mit dem Monitoring von Drittanbietern. So können Sie einem Kunden innerhalb von Minuten sagen, ob das Problem bei Ihnen liegt oder beim Anbieter.
Testverkehr sicher halten
Verwenden Sie für Monitoring-Anfragen ein eigenes Testkonto oder einen eigenen API-Schlüssel und gestalten Sie Schreib-Checks idempotent, damit ein POST pro Minute Ihre Datenbank nicht mit Testdatensätzen füllt. Kennzeichnen Sie Monitoring-Traffic mit einem eigenen User-Agent-Header, damit Sie ihn leicht aus Ihren Analysen und Logs herausfiltern können.
Für Hintergrundjobs ohne eigenen Endpunkt nutzen Sie stattdessen das Cron-Job-Monitoring.
Die Tarife beginnen bei 9 € pro Monat bei jährlicher oder 12 € bei monatlicher Abrechnung, zzgl. MwSt. Alle Limits finden Sie auf der Preisseite, oder testen Sie 14 Tage kostenlos ohne Karte.