Home » Funktionen » API

Automatisieren Sie jeden Teil Ihrer Überwachung mit der Dotcom-Monitor API

Rating: 5
Author: Gregory S.

Erstellen Sie programmatisch Monitore, verwalten Sie Geräte und Aufgaben, orchestrieren Sie Lasttests und streamen Sie Echtzeit-Leistungsdaten in Ihre eigenen Dashboards, SIEMs und CI/CD-Pipelines – mit einer dokumentierten REST Web API und dem XML Reporting Service (XRS).

10.000+

Organisationen weltweit

99,99%

Plattform Verfügbarkeits-SLA

30+

Globale Monitoring-Standorte

Seit 1998

Marktführer im Website-Monitoring

Programmgesteuerte Überwachung

Was ist die Dotcom-Monitor API?

Die Dotcom-Monitor-Plattform ist vollständig skriptfähig. Alles, was Sie in der Weboberfläche tun können — vom Erstellen eines neuen HTTP-Monitors bis zum Abrufen eines Leistungsberichts über drei Monate — können Sie programmatisch über zwei ergänzende Dienste durchführen: die REST-basierte Web-API für die Konfiguration und den XML Reporting Service (XRS) für die Echtzeit-Datenausgabe.

Die Web-API ist eine strukturierte, JSON-basierte HTTP-Schnittstelle, die Überwachungs- und Lasttest-Operationen für Ihre eigenen Systeme verfügbar macht. Verwenden Sie sie, um bei jeder Bereitstellung neue Monitore zu erstellen, Tausende von Geräten unter Configuration-as-Code zu verwalten, Monitoring in Ihre bestehenden Ticketing-Tools einzubinden oder Live-Leistungsdaten in kundenseitige Statusseiten einzubetten.

Der XML Reporting Service (XRS) ist ein kostenloser On-Demand-Datenfeed, der Überwachungsergebnisse als XML-Dokumente zurückgibt. Richten Sie ihn auf jedes Reporting-Dashboard, BI-Tool, Excel-Arbeitsbuch oder interne Datenbank, um benutzerdefinierte Ansichten ohne Wartezeiten durch die Entwickler zu erstellen.

Zusammen bieten sie Ihrer Plattform, SRE- und DevOps-Teams vollständige programmgesteuerte Kontrolle — ohne UI-Klicks erforderlich.

Konfigurieren Sie HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView und MetricsView-Monitore via JSON
Importieren, aktualisieren und entfernen Sie Geräte, Aufgaben, Gruppen und Scheduler im großen Stil
Ziehen Sie unverarbeitete oder aggregierte Leistungsdaten (stündliche, tägliche, wöchentliche, monatliche, jährliche Zusammenfassungen)
Stellen Sie Monitoring über Jenkins, GitHub Actions, Azure DevOps, GitLab CI oder jede HTTP-fähige Pipeline bereit

Web API — Schnellreferenz

https://api.dotcom-monitor.com/config_api_v1/

Format

JSON-Anfrage / JSON-Antwort

Methoden

GET (lesen) · POST / PUT (schreiben / aktualisieren)

Auth

Pro Anfrage, 60-Sekunden-Sitzung; optionale IP-Whitelist

Transport

HTTP oder HTTPS

XRS — Schnellreferenz

https://xmlreporter.dotcom-monitor.com/reporting/xml/

Format

XML-Antwort über HTTP(S) GET

Auth

Account UID (PID), generiert in Manage > Integrations

Daten-Tiefe

Unverarbeitete Antworten bis zu 6 Monate zurück

Kosten

Kostenlos, in jedem Konto enthalten

Einen Schlüssel generieren

Erstellen Sie eine Web-API- oder XML-Feed-Integration in Ihrem Konto.

Konfigurieren

POST JSON zum Erstellen von Geräten, Aufgaben, Gruppen, Zeitplänen und Warnungen.

Überwachen

Ausführungen laufen von über 30 globalen Standorten nach Ihrem definierten Zeitplan.

Extrahieren

Ergebnisse via XRS in Dashboards, BI, Excel oder interne Apps ziehen.

Kern-API-Funktionen

Alles, was die UI kann – als Code

Jedes Überwachungsobjekt in Ihrem Konto ist eine erstklassige API-Ressource. Verwalten Sie diese einzeln oder gesammelt über Umgebungen hinweg.

Vollständige Monitor-Konfiguration

Erstellen und bearbeiten Sie HTTPS-, REST-, SOAP-, GraphQL- und mehrstufige API-Monitore
Konfigurieren Sie BrowserView-, UserView-, ServerView- und MetricsView-Geräte
Fügen Sie Authentifizierung hinzu: OAuth 2.0, API-Schlüssel, Bearer-Token, Basic, NTLM, mTLS
Definieren Sie JSONPath- / XPath-Aussagen und benutzerdefinierte Antwortvalidierung

Geräte-, Aufgaben- und Gruppenverwaltung

Geräte bereitstellen und die Aufgaben, die unter ihnen liegen
Monitore in Gruppen mit vererbten Warnungen und Filtern organisieren
Konfigurationsänderungen in mehreren Umgebungen gleichzeitig anwenden
Geräte zwischen Staging-, QA- und Produktionskonten klonen

Standorte & Zeitpläne

Jeden verfügbaren globalen Überwachungsstandort auflisten
Prüfungen bestimmten Regionen oder Ihren Private Agents zuweisen
Zeitbasierte Zeitpläne erstellen (Geschäftszeiten, Wartungsfenster)
Filter programmatisch anwenden, um bekanntes Rauschen zu unterdrücken

Warnungen & Benachrichtigungsintegrationen

Alarmgruppen über API erstellen, aktualisieren und weiterleiten
Empfängerlisten, Eskalationsrichtlinien und Bereitschaftsdienste verwalten
Push-Benachrichtigungen an Slack, PagerDuty, Teams, OpsGenie, Webhooks
Automatisches Eskalationstuning ohne UI-Kontakt

XRS Echtzeit-Berichtsfeed

Uptime, Antwortzeit, TTFB und Fehlerdaten auf Abruf abrufen
Rohdaten oder Zusammenfassungen zurückgeben (Stunde / Tag / Woche / Monat / Jahr)
Filtern nach Gerät, Standort, Zeitplan, Erfolg / Fehler, Abteilung
In SQL, Excel, Power BI, Grafana oder benutzerdefinierte Dashboards streamen

So funktioniert es

Von Null bis zur automatisierten Überwachung in vier Schritten

Keine SDK-Installation erforderlich. Wenn Ihr System eine HTTP-Anfrage stellen kann, kann es mit Dotcom-Monitor kommunizieren.

Erstellen Sie eine Integration

Gehen Sie in Ihrem Dotcom-Monitor-Konto zu Manage > Integrations und erstellen Sie eine neue Web API-Integration (zur Konfiguration) oder eine XML Feed-Integration (für Berichte). Optional können Sie den Zugriff über IP-Adressen einschränken.

Authentifizieren

Jede Anfrage authentifiziert sich über Ihre Integration. Sitzungen laufen nach 60 Sekunden Inaktivität ab, wodurch der Zugriff kurzzeitig und sicher bleibt. XRS-Anfragen verwenden Ihre generierte Account-UID (PID).

Senden Sie JSON-Anfragen

Verwenden Sie GET für Lesevorgänge oder POST/PUT für Schreibvorgänge. Setzen Sie Content-Type: application/json, wenn Sie einen Body senden. Fehler werden als strukturierte JSON zurückgegeben.

Automatisieren Sie überall

Integrieren Sie die API in Terraform, Jenkins, GitHub Actions, Azure DevOps oder eigene Skripte. Starten Sie die Monitor-Bereitstellung beim Deployment, ziehen Sie Leistungsdaten in BI oder lösen Sie automatisch Benachrichtigungen bei SLA-Verstößen aus.

Technische Spezifikationen

Zwei APIs. Ein Konto. Volle Kontrolle.

Die Web API übernimmt die Konfiguration; XRS die Berichterstattung. Sie teilen ein Authentifizierungsmodell und funktionieren mit jeder Dotcom-Monitor-Lösung.

Web API (Konfiguration & Steuerung)

Verwalten Sie Ihre Überwachungsinfrastruktur programmatisch.

Basis-URL

api.dotcom-monitor.com/config_api_v1/

Protokolle

HTTP, HTTPS

Request-Format

JSON (application/json)

Response-Format

JSON

Methoden

GET (lesen) · POST, PUT (schreiben / aktualisieren)

Authentifizierung

Web-API-Integrationsschlüssel, pro Anfrage Sitzung (60 Sekunden Timeout)

Zugangskontrolle

IP-Whitelist optional

Deckt ab

Monitoring + LoadView-Methoden

Verwaltete Objekte

Geräte, Aufgaben, Gruppen, Zeitpläne, Filter, Alarme, Standorte, Lasttests, Benutzer

Fehlerbehandlung

Strukturiertes JSON mit Fehlercodes & Nachrichten

XML Reporting Service (XRS)

Streamen Sie Echtzeit-Monitoring-Daten in alles, was XML spricht.

Basis-URL

xmlreporter.dotcom-monitor.com/reporting/xml/

Protokolle

HTTP, HTTPS

Request-Format

HTTP(S) GET mit URL-Parametern

Response-Format

XML-Dokument

Authentifizierung

Account-UID (PID), generiert als XML-Feed-Integration

Umfang

Kontenweit oder auf bestimmte Abteilungen beschränkt

Berichtstypen

Gerätekonfiguration, Status, Rohantworten, Zusammenfassungen (Stunde / Tag / Woche / Monat / Jahr), 3-Monats-Statistiken

Zeitraum

Bis zu den letzten 6 Monaten für Rohantworten

Filter

Standort, Zeitplan, Gerät, Erfolg / Fehler, Abteilung, Datumsbereich

Zielausgaben

Dashboards, SQL, Excel, Power BI, individuelle Apps

Entwicklerfreundlich

Einfache HTTP.
Keine SDKs erforderlich.

Jedes Monitoring-Objekt – Geräte, Aufgaben, Alarme, Gruppen, Zeitpläne – wird als JSON-Ressource dargestellt. So sieht es aus, Monitoring-Daten von XRS abzurufen und ein neues Gerät über die Web-API hinzuzufügen. Fügen Sie diese in einen curl, ein Bash-Skript, einen Python-Job oder einen CI-Schritt ein – was Ihr Team bereits verwendet.

Zurückgelieferte Felder umfassen DnsTime, SSLTime, ConnectionTime, RequestTime, FirstPacketTime (TTFB), DownloadTime und Duration sowie Standort, Status und Monitoring-Zeitstempel – bereit, in jede Wasserfallansicht eingefügt zu werden.

# Echtzeit-XRS-Bericht abrufen – Zusammenfassung nach Standort
GET https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx
     ?PID=4229AF4F0FB545AEA75EAF2013E51BB7
     &Site=12345
     &Type=Overall
     &location=NY, USA

# Antwort (gekürzt)
<Response>
  <ID>3424533543</ID>
  <Name>Checkout API</Name>
  <URL>https://shop.example.com/api/checkout</URL>
  <Duration>114</Duration>
  <DnsTime>0</DnsTime>
  <SSLTime>18</SSLTime>
  <ConnectionTime>15</ConnectionTime>
  <FirstPacketTime>97</FirstPacketTime>
  <DownloadTime>2</DownloadTime>
  <Status>S</Status>
</Response>

# Einen neuen HTTPS-Monitor über die Web-API erstellen
POST https://api.dotcom-monitor.com/config_api_v1/devices
Content-Type: application/json

{
  "name": "Checkout API – Produktion",
  "platform": "HTTPS",
  "tasks": [{
    "url": "https://shop.example.com/api/checkout",
    "method": "POST",
    "keyword": "order_id"
  }],
  "frequency": 60,
  "locations": ["NY-USA", "FR-PARIS", "SG"]
}

Beginnen Sie, Ihr Monitoring in 5 Minuten zu automatisieren

Jeder kostenpflichtige Tarif beinhaltet vollen Zugriff auf die Web-API und XRS – keine Zusatzpakete, keine Abrechnung pro Anfrage, keine zusätzliche Abrechnungsebene.

Anwendungsfälle

Was Teams mit der API bauen

Platform-Teams, SREs und DevOps-Ingenieure nutzen die Dotcom-Monitor-API, um Monitoring in die Workflows zu integrieren, in denen sie bereits arbeiten.

Monitoring-as-Code

Versionieren Sie jeden Monitor zusammen mit dem Service, den er schützt. Stellen Sie Geräte über Ihre bestehende Terraform- oder Pulumi-Pipeline bereit, aktualisieren Sie diese und nehmen Sie sie außer Betrieb – keine Abweichungen zwischen Staging und Produktion.

Post-Deploy Smoke Tests

Lösen Sie HTTPS- und Multi-Step-Transaktionsprüfungen auf Abruf über Jenkins, GitHub Actions oder Azure DevOps nach jedem Deployment aus. Brechen Sie den Build ab, wenn ein neues Release einen kritischen Endpunkt kaputt macht.

Benutzerdefinierte Statusseiten & Dashboards

Speisen Sie XRS-Daten in kundenorientierte Uptime-Seiten, interne NOC-Anzeigen oder Executive-SLA-Berichte ein. Ziehen Sie nur die Felder, die Sie wollen, formatiert genau so, wie Sie sie benötigen.

SLA-Nachweise & Compliance-Reporting

Automatisieren Sie monatliche SLA-Exporte (Uptime %, P95 / P99-Antwortzeit, Ausfallzeitvorfälle) direkt aus XRS in Excel oder PDF – dokumentiert, mit Zeitstempel und revisionssicher.

Massenhafte Gerätebereitstellung

Starten Sie Hunderte von Monitoren in einem Durchgang nach einer Akquisition, Migration oder einem CDN-Wechsel. Klonen Sie bestehende Gerätevorlagen und weisen Sie im großen Umfang die richtigen Gruppen, Zeitpläne und Alarmrouten zu.

Embedding von Dashboards Dritter

Leiten Sie Monitoring-Daten neben Ihrer anderen Telemetrie in Grafana, Power BI, Tableau oder Datadog – externe synthetische Prüfungen korreliert mit internen APM-Traces.

Multi-Tenant-Kontenverwaltung

MSPs und Enterprise-Teams können Hunderte von Abteilungen und Tausende von Geräten in einer einzigen programmatischen Aktion verwalten, mit abteilungsspezifischen XRS-Feeds für jeden Kunden.

Incident-Enrichment

Wenn ein Monitor anschlägt, ziehen Sie das Waterfall, den Cipher und die Timing-Aufschlüsselung über XRS und hängen sie automatisch an den PagerDuty- oder ServiceNow-Vorfall an – das verkürzt die Triage-Zeit.

XRS Deep-Dive

Echtzeit-Reporting, genau so wie Sie es brauchen

Der XML Reporting Service ist ein flexibler, kostenloser, On-Demand-Feed. Fragen Sie nach Zusammenfassungsdaten oder rohen Antworten. Filtern Sie nach Standort, Zeitplan oder Erfolgsstatus. Geben Sie nur die Felder zurück, die Ihnen wichtig sind.

Berichtstyp	Was Sie erhalten	Typischer Anwendungsfall
Kontonutzung	Genutzte und verfügbare Ressourcen pro Überwachungslösung	Lizenz- & Kapazitätsplanung, Abrechnungsausgleich
Gerätestatus	Aktueller Zustand & Status einzelner Geräte oder Gruppen	Live-Statusseiten, NOC-Wand-Dashboards
Antwortdetails	Hochgradig anpassbare zeitliche & inhaltliche Details pro Anfrage	Detaillierte Diagnosen, benutzerdefinierte Wasserfälle, Vorfallanreicherung
Geräte- & Aufgaben-Konfiguration	Exportierte Konfigurations-Snapshots der Überwachung	Backups, plattformübergreifende Klonungen, Prüfpfade
Zusammenfassende Daten	Betriebszeit, Ausfallzeit, Erfolgsanzahl, Fehlgeschlagenanzahl, Leistung, StDev	Executive Summaries, SLA-Berichte
Rohantworten	Jedes Prüfergebnis für ein Gerät, bis zu 6 Monate zurück	Forensische Analysen, historische Vergleiche
Stündliche Aggregationen	Antwortdaten gebündelt in 1-Stunden-Fenstern	Spitzenlast-Erkennung, stündliche Trendanalyse
Tägliche Aggregationen	Antwortdaten gebündelt in 24-Stunden-Fenstern	Tägliche Betriebsreviews, Geschäftstag- vs. Wochenende-Vergleiche
Wöchentliche / monatliche / jährliche	Zusammenfassungen über längere Zeiträume	Vorstandsebene Trending, Jahresvergleich Leistungsberichte
3-Monats-Statistiken	Statistische Daten, berechnet über ein rollierendes 3-Monats-Fenster	Basislinien-abgeleitete Alarmierung, Anomalieerkennung

Jeder Bericht kann nach Überwachungsort, Zeitplan, Dotcom-Monitor Filter, Erfolgs- oder Fehlerstatus, Abteilung und benutzerdefiniertem Datumsbereich gefiltert werden.

Warum Teams die API verwenden

Entwickelt für DevOps, SRE & Plattform-Engineering

Die Dotcom-Monitor API entfernt manuelle UI-Klicks aus Ihrem Überwachungsworkflow, sodass Ihr Team die synthetische Abdeckung ohne Personalaufstockung skalieren kann.

Drift eliminieren

Behalten Sie die Überwachungskonfiguration in der Quellcodeverwaltung. Wenden Sie dieselben Monitore mit Vertrauen in verschiedenen Umgebungen an.

Monitoring nach links verlagern

Fügen Sie synthetische Prüfungen im selben PR wie den Dienst hinzu, den sie abdecken. Monitoring wird mit dem Code bereitgestellt, nicht Wochen später.

Skalierung ohne Klicks

Onboarden Sie hundert neue Domains oder tausend neue Endpunkte mit einem einzigen Skript. Keine Klickmüdigkeit.

Granulare Sicherheit

Kurzlebige Sitzungen, optionale IP-Whitelist und abteilungsbezogene Integrationstasten sorgen für strengen Zugriffsschutz.

Passt zu jedem Stack

Einfaches HTTP + JSON (oder GET + XML für Berichte). Keine SDK-Bindung. Funktioniert mit jeder Sprache und jedem CI/CD-Tool.

Besitzen Sie Ihre Daten

Ziehen Sie Ihre Überwachungsdaten in Ihr eigenes Data Warehouse, BI-Plattform oder Compliance-Archiv nach Ihrem Zeitplan.

Vereinheitlichte Oberfläche

Eine API deckt Überwachung und LoadView-Lasttests ab — kein separates Tool, keine separaten Zugangsdaten.

Keine Zusatzkosten

API- und XRS-Zugriff sind in jedem kostenpflichtigen Plan enthalten. Keine Abrechnung pro Aufruf, keine Zusatzkosten für Automatisierung.

Was unsere Kunden sagen

"Eine der besten Funktionen von Dotcom sind die Push/Pull-API-Fähigkeiten, die uns Netzwerkleistungsdaten liefern. Wir nutzen diese, um Leistungsprobleme sowie Seitenladezeiten zu überwachen. Dotcom-Monitor ermöglicht es uns, mehrere Dienste innerhalb einer Oberfläche und Plattform zu überwachen. Das hat uns eine effizientere Arbeitsweise ermöglicht."

Gregory S.

Manager, Rundfunkmedien · Verifizierte Capterra-Bewertung

Bereit, Ihr Monitoring auf Autopilot zu stellen?

Jede 30-tägige Testversion beinhaltet vollen Web API- und XRS-Zugriff — plus jede Monitoring-Lösung, jeden Standort und jede Integration. Erleben Sie, wie sich automatisiertes Monitoring anfühlt.

Häufig gestellte Fragen

Häufige Fragen zur Dotcom-Monitor API

Was ist der Unterschied zwischen der Web API und XRS?

Die Web API (config_api_v1) ist eine JSON-basierte REST-Schnittstelle zur Erstellung und Verwaltung von Überwachungskonfigurationen — Geräte, Aufgaben, Gruppen, Zeitpläne, Alarme und Lasttests. Der XML Reporting Service (XRS) ist ein separater, kostenloser Feed, der Überwachungsergebnisse als XML via HTTP GET zurückgibt. Die meisten Teams nutzen beide: Web API zur Konfiguration und XRS zum Abrufen der Ergebnisse.

Wie authentifiziere ich mich bei der API?

Gehen Sie in Ihrem Dotcom-Monitor-Konto zu Manage > Integrations > New Integration und erstellen Sie entweder eine Web API-Integration (für die Konfiguration) oder eine XML Feed-Integration (für XRS). Jede Web API-Anfrage wird gegen diese Integration authentifiziert, und Sitzungen laufen nach 60 Sekunden Inaktivität ab. XRS verwendet die generierte Account-UID als PID-URL-Parameter. Sie können den Zugriff auch nach IP-Adresse einschränken.

Welche Datenformate werden unterstützt?

Die Web API ist vollständig JSON-basiert — sowohl Anforderungsinhalte als auch Antworten. Setzen Sie Content-Type: application/json, wenn Sie einen JSON-Körper senden. XRS liefert XML-Dokumente über HTTP(S) GET, die Anforderung ist also nur eine URL mit Abfrageparametern.

Welche Monitoring-Typen kann ich über die API konfigurieren?

Die Web API deckt jede Dotcom-Monitor-Monitoring-Plattform ab: HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView (EveryStep-Skripte) und MetricsView — sowie alle Protokollmonitore (DNS, SSL, E-Mail, FTP, ICMP Ping, TCP Port, Traceroute, VoIP und mehr). Sie umfasst auch die gesamte LoadView-Lasttest-Oberfläche.

Gibt es eine Ratenbegrenzung oder Kosten pro Anfrage?

API- und XRS-Zugriff sind in jedem kostenpflichtigen Plan enthalten — es gibt keine Abrechnung pro Anfrage und keine Zusatzgebühren. Sitzungen laufen nach 60 Sekunden Inaktivität ab, was lange laufende Skripte natürlich begrenzt. Wenn Sie IP-eingeschränkten Zugriff oder unternehmensweiten Durchsatz benötigen, kontaktieren Sie den Vertrieb wegen Enterprise-Optionen.

Wie weit kann ich historische Daten über XRS abrufen?

XRS kann Rohdaten für bis zu die letzten 6 Monate zurückgeben. Zusammenfassungs- und statistische Berichte (stündliche / tägliche / wöchentliche / monatliche / jährliche Aggregationen und 3-Monats-Statistiken) sind über längere Zeiträume verfügbar. Sie geben für jeden Bericht Start- und Enddatum/-zeit an.

Kann ich die API für CI/CD-Pipelines verwenden?

Ja – jedes Tool, das einen HTTP-Aufruf ausführen kann, kann die API ansteuern. Teams integrieren häufig Jenkins, GitHub Actions, GitLab CI, Azure DevOps, CircleCI und Terraform, um Monitore bei Bereitstellung zu provisionieren, Nach-Release Smoke-Tests auszuführen und Produktionsrollouts basierend auf der Überwachungsqualität zu steuern.

Kann ich den API-Zugriff auf bestimmte IP-Adressen beschränken?

Ja. Wenn Sie eine Web-API-Integration erstellen, können Sie Zugriff von allen authentifizierten Anfragen erlauben oder den Zugriff auf eine Liste vertrauenswürdiger IP-Adressen beschränken. Details finden Sie im Artikel IPs für Web-API-Zugriff auf die Whitelist setzen in der Knowledge Base.

Unterstützt die API Multi-Department- oder MSP-Konten?

Ja. Nutzer eines Root-Kontos können Abteilungen programmatisch verwalten, und eine XML-Feed-Integration kann auf spezifische Abteilungen beschränkt werden. Abteilungsbegrenzte Nutzer können XRS-Berichte nur für ihre eigene Abteilung abrufen, was eine klare Trennung für MSPs und Multi-Tenant-Setups unterstützt.

Wo finde ich vollständige Dokumentation und Codebeispiele?

Die vollständige Dokumentation finden Sie in der Dotcom-Monitor Knowledge Base, einschließlich des Getting Started with the API-Leitfadens, der Monitoring- und LoadView-Methode Referenzen mit JSON-Beispielen und der XRS-Anfrageparameter-Referenz. Fertige Code-Vorlagen sind im Bereich Code Examples verfügbar.

Automatisieren Sie das Monitoring.Gewinnen Sie Engineering-Zeit zurück.

Schließen Sie sich über 10.000 Organisationen an, die Dotcom-Monitor nutzen, um Ausfälle zu erkennen, bevor es die Kunden tun – und die API und XRS zu verwenden, um diese Abdeckung mühelos zu verwalten.