Automatisez Chaque Partie de Votre Surveillance avec l’API Dotcom-Monitor

Rating: 5
Author: Gregory S.

Créez des moniteurs programmatiqueiment, gérez les appareils et les tâches, orchestrez les tests de charge, et diffusez les données de performance en temps réel dans vos propres tableaux de bord, SIEMs et pipelines CI/CD — avec une API Web REST documentée et le Service de Rapports XML (XRS).

10 000+

Organisations dans le Monde

99,99 %

SLA de Disponibilité de la Plateforme

30+

Sites Mondiaux de Surveillance

Depuis 1998

Leader en Surveillance de Sites Web

Surveillance Programmable

Qu’est-ce que l’API Dotcom-Monitor ?

La plateforme Dotcom-Monitor est entièrement scriptable. Tout ce que vous pouvez faire dans l’interface web — de la création d’un nouveau moniteur HTTP à l’extraction d’un rapport de performance de trois mois — peut être fait de manière programmatique via deux services complémentaires : le Web API basé sur REST pour la configuration et le XML Reporting Service (XRS) pour l’extraction de données en temps réel.

Le Web API est une interface HTTP structurée, basée sur JSON, qui expose les opérations de surveillance et de test de charge à vos propres systèmes. Utilisez-le pour provisionner de nouveaux moniteurs à chaque déploiement, gérer des milliers d’appareils sous configuration-as-code, intégrer la surveillance à vos outils de ticketing existants, ou intégrer des données de performance en direct dans des pages de statut destinées aux clients.

Le XML Reporting Service (XRS) est un flux de données gratuit à la demande qui renvoie les résultats de surveillance sous forme de documents XML. Pointez-le vers n’importe quel tableau de bord de rapport, outil BI, classeur Excel ou base de données interne pour créer des vues personnalisées sans attendre l’ingénierie.

Ensemble, ils offrent à vos équipes plateforme, SRE et DevOps un contrôle programmatique complet — sans clics dans l’interface utilisateur.

Configurer des moniteurs HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView, et MetricsView via JSON
Importer, mettre à jour et supprimer des appareils, tâches, groupes, et planificateurs à grande échelle
Extraire des données de performance brutes ou agrégées (résumés horaires, quotidiens, hebdomadaires, mensuels, annuels)
Provisionner la surveillance depuis Jenkins, GitHub Actions, Azure DevOps, GitLab CI, ou tout pipeline compatible HTTP

Web API — Référence rapide

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

Format

Requête JSON / Réponse JSON

Méthodes

GET (lecture) · POST / PUT (écriture / mise à jour)

Auth

Par requête, session de 60 secondes ; liste blanche IP optionnelle

Transport

HTTP ou HTTPS

XRS — Référence rapide

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

Format

Réponse XML via HTTP(S) GET

Auth

UID de compte (PID) généré dans Manage > Integrations

Profondeur des données

Réponses brutes remontant jusqu’à 6 mois

Coût

Gratuit, inclus avec chaque compte

Générer une clé

Créez une intégration Web API ou XML Feed dans votre compte.

Configurer

POST JSON pour créer des appareils, tâches, groupes, horaires et alertes.

Surveiller

L’exécution se fait depuis plus de 30 emplacements mondiaux selon votre calendrier défini.

Extraire

Récupérez les résultats via XRS dans des tableaux de bord, BI, Excel ou des applications internes.

Fonctionnalités principales de l’API

Tout ce que l’interface peut faire — en code

Chaque objet de surveillance dans votre compte est une ressource API de première classe. Gérez-les individuellement ou en masse à travers les environnements.

Configuration complète du moniteur

Créer et modifier des moniteurs API HTTPS, REST, SOAP, GraphQL et multi-étapes
Configurer des appareils BrowserView, UserView, ServerView et MetricsView
Joindre une authentification : OAuth 2.0, clés API, jetons Bearer, Basic, NTLM, mTLS
Définir des assertions JSONPath / XPath et une validation personnalisée des réponses

Gestion des appareils, tâches et groupes

Provisionner les appareils et les tâches qui y sont rattachées
Organiser les moniteurs en groupes avec alertes et filtres hérités
Appliquer en masse les modifications de configuration à travers les environnements
Cloner des appareils entre comptes de staging, QA et production

Emplacements & Horaires

Lister tous les emplacements de surveillance globaux disponibles
Attribuer des contrôles à des régions spécifiques ou à vos agents privés
Créer des horaires basés sur le temps (heures ouvrables, fenêtres de maintenance)
Appliquer des filtres de manière programmatique pour supprimer les bruits connus

Alertes & Intégrations de Notification

Créer, mettre à jour, et diriger les groupes d’alerte via API
Gérer les listes de destinataires, les politiques d’escalade et les rotations de garde
Envoyer des notifications vers Slack, PagerDuty, Teams, OpsGenie, webhooks
Automatiser le réglage des escalades sans toucher à l’UI

Flux de Rapport Temps Réel XRS

Extraire les données de disponibilité, temps de réponse, TTFB, et erreurs à la demande
Retourner des réponses brutes ou des résumés (heure / jour / semaine / mois / année)
Filtrer par appareil, emplacement, horaire, succès / échec, département
Diffuser dans SQL, Excel, Power BI, Grafana, ou tableaux de bord personnalisés

Comment Ça Fonctionne

De Zéro à la Surveillance Automatisée en Quatre Étapes

Aucun SDK à installer. Si votre système peut effectuer une requête HTTP, il peut communiquer avec Dotcom-Monitor.

Créer une Intégration

Dans votre compte Dotcom-Monitor, allez dans Gérer > Intégrations et créez une nouvelle intégration Web API (pour la configuration) ou une intégration Flux XML (pour les rapports). Vous pouvez optionnellement restreindre l’accès par adresse IP.

Authentifiez-vous

Chaque requête s’authentifie auprès de votre intégration. Les sessions expirent après 60 secondes d’inactivité, garantissant un accès temporaire et sécurisé. Les requêtes XRS utilisent votre UID de compte généré (PID).

Envoyer des requêtes JSON

Utilisez GET pour les lectures ou POST/PUT pour les écritures. Définissez Content-Type: application/json lors de l’envoi d’un corps. Les erreurs retournent du JSON structuré.

Automatisez partout

Connectez l’API à Terraform, Jenkins, GitHub Actions, Azure DevOps ou vos propres scripts. Déclenchez la provision de moniteurs lors du déploiement, récupérez les données de performance dans un BI, ou envoyez des alertes automatiques en cas de non-respect des SLA.

Spécifications Techniques

Deux API. Un Compte. Contrôle Total.

L’API Web gère la configuration ; XRS gère les rapports. Ils partagent un modèle d’authentification unique et fonctionnent avec chaque solution Dotcom-Monitor.

Web API (Config & Contrôle)

Gérez votre infrastructure de surveillance de façon programmatique.

URL de base

api.dotcom-monitor.com/config_api_v1/

Protocoles

HTTP, HTTPS

Format de la requête

JSON (application/json)

Format de la réponse

JSON

Méthodes

GET (lecture) · POST, PUT (écriture / mise à jour)

Authentification

Clé d’intégration Web API, session par requête (timeout 60s)

Contrôle d’accès

Liste blanche IP optionnelle

Couvre

Méthodes de monitoring + LoadView

Objets gérés

Appareils, tâches, groupes, plannings, filtres, alertes, emplacements, tests de charge, utilisateurs

Gestion des erreurs

JSON structuré avec codes d’erreur & messages

Service de Rapport XML (XRS)

Diffusez des données de monitoring en temps réel vers tout ce qui comprend XML.

URL de base

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

Protocoles

HTTP, HTTPS

Format de la requête

GET HTTP(S) avec paramètres URL

Format de la réponse

Document XML

Authentification

UID de compte (PID), généré en tant qu’intégration de flux XML

Périmètre

Compte entier ou limité à des départements spécifiques

Types de rapports

Configuration de l’appareil, statut, réponses brutes, résumés (heure / jour / semaine / mois / année), statistiques sur 3 mois

Fenêtre de données

Jusqu’aux 6 derniers mois pour les réponses brutes

Filtres

Emplacement, planning, appareil, succès / échec, département, plage de dates

Cibles de sortie

Tableaux de bord, SQL, Excel, Power BI, applications personnalisées

Convivial pour les développeurs

HTTP Simple.
Pas de SDK requis.

Chaque objet de surveillance — appareils, tâches, alertes, groupes, plannings — est représenté comme une ressource JSON. Voici à quoi ressemble l’extraction des données de surveillance depuis XRS et l’ajout d’un nouvel appareil via l’API Web. Intégrez cela dans un curl, un script bash, un job Python ou une étape CI — selon ce que votre équipe utilise déjà.

Les champs retournés incluent DnsTime, SSLTime, ConnectionTime, RequestTime, FirstPacketTime (TTFB), DownloadTime, et Duration, ainsi que l’emplacement, le statut, et l’horodatage de surveillance — prêts à être intégrés dans toute vue en cascade.

# Extraire un rapport XRS en temps réel — résumé par emplacement
GET https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx
     ?PID=4229AF4F0FB545AEA75EAF2013E51BB7
     &Site=12345
     &Type=Overall
     &location=NY, USA

# Réponse (abrégée)
<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>

# Créer un nouveau moniteur HTTPS via l’API Web
POST https://api.dotcom-monitor.com/config_api_v1/devices
Content-Type: application/json

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

Commencez à automatiser votre surveillance en 5 minutes

Chaque plan payant inclut un accès complet à l’API Web et XRS — pas d’add-ons, pas de facturation à l’appel, pas de niveau de facturation supplémentaire.

Cas d'utilisation

Ce que les équipes construisent avec l'API

Les équipes plateformes, SRE et ingénieurs DevOps utilisent l’API Dotcom-Monitor pour intégrer la surveillance dans les flux de travail qu’ils utilisent déjà.

Monitoring-as-Code

Versionnez chaque moniteur en même temps que le service qu’il protège. Provisionnez, mettez à jour et désactivez des appareils via votre pipeline Terraform ou Pulumi existant — pas de dérive entre la préproduction et la production.

Tests de fumée post-déploiement

Déclenchez des contrôles HTTPS et des transactions multi-étapes à la demande depuis Jenkins, GitHub Actions ou Azure DevOps après chaque déploiement. Faites échouer la construction lorsqu’une nouvelle version casse un point critique.

Pages de statut personnalisées et tableaux de bord

Alimentez les données XRS dans des pages de uptime destinées aux clients, des affichages NOC internes ou des rapports SLA exécutifs. Extrayez uniquement les champs souhaités, formatés exactement comme vous le souhaitez.

Preuves SLA et rapports de conformité

Automatisez les exports mensuels des SLA (%, P95 / P99 temps de réponse, incidents de panne) directement depuis XRS vers Excel ou PDF — documenté, horodaté et prêt pour l’audit.

Provisionnement en masse des appareils

Lancez des centaines de moniteurs en une seule fois après une acquisition, une migration ou un basculement CDN. Clonez des modèles d’appareils existants et assignez les bons groupes, horaires, et routes d’alerte à grande échelle.

Intégration de tableau de bord tiers

Intégrez les données de surveillance dans Grafana, Power BI, Tableau ou Datadog aux côtés de votre autre télémétrie — contrôles synthétiques externes corrélés avec les traces APM internes.

Gestion multi-locataire des comptes

Les MSP et les équipes d’entreprise peuvent gérer des centaines de départements et des milliers d’appareils en une seule opération programmatique, avec des flux XRS à périmètre départemental pour chaque client.

Enrichissement des incidents

Lorsqu’un moniteur s’active, récupérez la cascade, le cipher et la répartition temporelle via XRS et attachez-les automatiquement à l’incident PagerDuty ou ServiceNow — réduisant le temps de triage.

Présentation approfondie de XRS

Rapports en temps réel, exactement comme vous en avez besoin

Le XML Reporting Service est un flux flexible, gratuit et à la demande. Demandez des données résumées ou des réponses brutes. Filtrez par emplacement, planning ou état de succès. Retournez uniquement les champs qui vous intéressent.

Type de rapport	Ce que vous obtenez	Utilisation typique
Utilisation du compte	Ressources utilisées et disponibles par solution de surveillance	Planification des licences et de la capacité, rapprochement de facturation
État de l’appareil	État et statut actuels des appareils individuels ou des ensembles	Pages d’état en direct, tableaux de bord muraux NOC
Détails de la réponse	Minutage et contenu très personnalisables par requête	Diagnostics détaillés, cascades personnalisées, enrichissement des incidents
Configuration de l’appareil et des tâches	Instantanés de configuration de surveillance exportés	Sauvegardes, clonage inter-environnements, pistes d’audit
Données résumées	Temps de disponibilité, temps d’indisponibilité, nombre de réussites, nombre d’échecs, performance, écart type	Synthèses exécutives, rapports SLA
Réponses brutes	Chaque résultat de vérification pour un appareil, jusqu’à 6 mois en arrière	Analyse médico-légale, comparaisons historiques
Agrégats horaires	Données de réponse regroupées en fenêtres de 1 heure	Identification des pics de charge, analyse des tendances horaires
Agrégats quotidiens	Données de réponse regroupées en fenêtres de 24 heures	Revues opérationnelles quotidiennes, comparaisons jour ouvrable vs. week-end
Hebdomadaires / mensuels / annuels	Synthèses sur des horizons temporels plus longs	Tendances au niveau du conseil d’administration, rapports de performance annuels
Statistiques sur 3 mois	Données statistiques calculées sur une fenêtre glissante de 3 mois	Alertes dérivées de la ligne de base, détection d’anomalies

Chaque rapport peut être filtré par emplacement de surveillance, planning, Filtre Dotcom-Monitor, état de succès ou d’échec, service, et plage de dates personnalisée.

Pourquoi les équipes utilisent l'API

Conçu pour DevOps, SRE & Ingénierie de Plateforme

L’API Dotcom-Monitor supprime les clics manuels de l’interface utilisateur de votre flux de travail de surveillance afin que votre équipe puisse étendre la couverture synthétique sans augmenter les effectifs.

Éliminer la dérive

Conservez la configuration de surveillance dans le contrôle de source. Appliquez les mêmes moniteurs sur plusieurs environnements en toute confiance.

Déplacer la surveillance à gauche

Ajoutez des contrôles synthétiques dans la même PR que le service qu’ils couvrent. La surveillance accompagne le code, pas des semaines plus tard.

Évoluer sans clics

Intégrez une centaine de nouveaux domaines ou mille nouveaux points de terminaison avec un seul script. Pas de fatigue des clics.

Sécurité granulaire

Sessions de courte durée, liste blanche IP optionnelle et clés d’intégration limitées au service maintiennent un accès strict.

Convient à toute pile

HTTP simple + JSON (ou GET + XML pour les rapports). Pas de verrouillage SDK. Fonctionne avec tous les langages et outils CI/CD.

Possédez vos données

Importez vos données de surveillance dans votre propre entrepôt de données, plateforme BI ou archive de conformité selon votre calendrier.

Surface unifiée

Une seule API couvre la surveillance et le test de charge LoadView — pas d’outil séparé, pas d’identifiants séparés.

Pas de coût supplémentaire

L’accès à l’API et à XRS est inclus dans chaque plan payant. Pas de facturation par appel, pas de surcoût pour l’automatisation.

Ce que disent nos clients

"L'une des meilleures fonctionnalités de Dotcom est la capacité de l'API push/pull qui nous fournit des données sur la performance du réseau. Nous l'utilisons pour surveiller les problèmes de performance ainsi que les statistiques de chargement des pages. Dotcom-Monitor nous permet de surveiller plusieurs services au sein d'une seule interface et plateforme. Cela nous a permis de fonctionner plus efficacement."

Gregory S.

Manager, Médias de diffusion · Avis vérifié Capterra

Prêt à automatiser votre surveillance ?

Chaque essai de 30 jours inclut un accès complet à l’API Web et à XRS — ainsi que chaque solution de surveillance, chaque emplacement et chaque intégration. Découvrez ce que ressent une surveillance automatisée.

Questions fréquentes

Questions courantes sur l'API Dotcom-Monitor

Quelle est la différence entre l'API Web et XRS ?

L’API Web (config_api_v1) est une interface REST basée sur JSON pour créer et gérer la configuration de la surveillance — appareils, tâches, groupes, horaires, alertes et tests de charge. Le Service de Rapports XML (XRS) est un flux gratuit séparé qui renvoie les résultats de la surveillance au format XML via HTTP GET. La plupart des équipes utilisent les deux : l’API Web pour configurer, XRS pour extraire les résultats.

Comment m'authentifier à l'API ?

Dans votre compte Dotcom-Monitor, allez dans Gérer > Intégrations > Nouvelle intégration et créez soit une intégration API Web (pour la configuration), soit une intégration Flux XML (pour XRS). Chaque requête API Web s’authentifie via cette intégration et les sessions expirent après 60 secondes d’inactivité. XRS utilise l’UID du compte généré en tant que paramètre URL PID. Vous pouvez aussi restreindre l’accès par adresse IP.

Quels formats de données sont pris en charge ?

L’API Web est entièrement JSON — à la fois les corps des requêtes et les réponses. Définissez Content-Type: application/json lors de l’envoi d’un corps JSON. XRS renvoie des documents XML via HTTP(S) GET, donc la requête est juste une URL avec des paramètres de requête.

Quels types de surveillance puis-je configurer via l'API ?

L’API Web couvre toutes les plateformes de surveillance Dotcom-Monitor : HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView (scripts EveryStep), et MetricsView — ainsi que tous les moniteurs de protocole (DNS, SSL, Email, FTP, ICMP Ping, TCP Port, Traceroute, VoIP, et plus). Elle couvre aussi toute la surface de tests de charge LoadView.

Y a-t-il une limite de débit ou un coût par appel ?

L’accès API et XRS est inclus avec chaque forfait payant — il n’y a pas de comptabilisation par appel ni de frais supplémentaires. Les sessions expirent après 60 secondes d’inactivité, ce qui limite naturellement les scripts longue durée. Si vous avez besoin d’un accès restreint par IP ou d’un débit au niveau entreprise, contactez les Ventes pour les options Enterprise.

Jusqu'à quelle date puis-je récupérer des données historiques via XRS ?

XRS peut retourner les données brutes de réponse pour jusqu’aux 6 derniers mois. Des rapports récapitulatifs et statistiques (aggrégats horaires / quotidiens / hebdomadaires / mensuels / annuels et statistiques sur 3 mois) sont disponibles sur des périodes plus longues. Vous spécifiez la date/heure de début et de fin pour chaque rapport.

Puis-je utiliser l'API pour les pipelines CI/CD ?

Oui — tout outil capable d’effectuer un appel HTTP peut piloter l’API. Les équipes intègrent couramment Jenkins, GitHub Actions, GitLab CI, Azure DevOps, CircleCI et Terraform pour provisionner des moniteurs lors du déploiement, exécuter des tests de fumée post-release et conditionner les déploiements en production sur la base de la santé du monitoring.

Puis-je restreindre l'accès à l'API à des adresses IP spécifiques ?

Oui. Lors de la création d’une intégration Web API, vous pouvez autoriser l’accès à toutes les requêtes authentifiées ou restreindre l’accès à une liste d’adresses IP de confiance. Voir l’article Comment mettre sur liste blanche des IP pour l’accès Web API dans la Base de Connaissances pour les détails.

L'API supporte-t-elle les comptes multi-départements ou MSP ?

Oui. Les utilisateurs d’un compte racine peuvent gérer les départements de manière programmatique, et une intégration XML Feed peut être limitée à des départements spécifiques. Les utilisateurs limités à un département ne peuvent tirer que des rapports XRS pour leur propre département, ce qui permet une séparation claire pour les MSP et les configurations multi-locataires.

Où puis-je trouver la documentation complète et des exemples de code ?

La documentation complète se trouve dans la Base de Connaissances Dotcom-Monitor, incluant le guide Premiers Pas avec l’API, les références des méthodes Monitoring et LoadView avec des exemples JSON, et la référence des paramètres de requête XRS. Des templates de code prêts à l’emploi sont disponibles dans la section Exemples de Code.

Automatisez le Monitoring.Récupérez du Temps d'Ingénierie.

Rejoignez plus de 10 000 organisations utilisant Dotcom-Monitor pour détecter les défaillances avant leurs clients — et utiliser l’API et XRS pour que cette couverture soit facile à gérer.