Home » Fonctionnalités » Surveillance API

Automatisez chaque partie de votre surveillance avec l'API Dotcom-Monitor

Rating: 5
Author: Gregory S.

Créez des moniteurs, gérez des appareils et des tâches, orchestrez des tests de charge et diffusez des données de performance en temps réel vers 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 entier

99,99%

SLA de disponibilité de la plateforme

30+

Sites de surveillance mondiaux

Depuis 1998

Leader en surveillance de site web

Surveillance Programmée

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 sur trois mois — vous pouvez le faire de manière programmée via deux services complémentaires : l’API Web REST pour la configuration et le Service de Reporting XML (XRS) pour l’extraction de données en temps réel.

L’API Web 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-la pour provisionner de nouveaux moniteurs à chaque déploiement, gérer des milliers d’appareils via la configuration sous forme de code, intégrer la surveillance dans vos outils de ticketing existants ou insérer des données de performance en direct dans des pages de statut destinées aux clients.

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

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

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

API Web — 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)

Authentification

Session par requête 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

Authentification

UID de compte (PID) généré dans Gérer > Intégrations

Profondeur des données

Réponses brutes jusqu’à 6 mois en arrière

Coût

Gratuit, inclus avec chaque compte

Générer une clé

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

Configurer

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

Surveiller

Les exécutions s’effectuent depuis plus de 30 emplacements mondiaux selon votre planning défini.

Extraire

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

Fonctionnalités principales de l'API

Tout ce que l'IU 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 HTTPS, REST, SOAP, GraphQL et multi-étapes
Configurer des appareils BrowserView, UserView, ServerView et MetricsView
Joindre l'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 associées
Organiser les moniteurs en groupes avec alertes et filtres hérités
Appliquer en masse des modifications de configuration entre environnements
Cloner des appareils entre les comptes de staging, QA et production

Emplacements et horaires

Lister tous les emplacements mondiaux de surveillance disponibles
Assigner 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 le bruit connu

Alertes et intégrations de notifications

Créer, mettre à jour et router des groupes d'alertes 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 l'ajustement des escalades sans toucher à l'interface utilisateur

Flux de rapports en temps réel XRS

Extraire les données de temps 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
Diffusez dans SQL, Excel, Power BI, Grafana ou des tableaux de bord personnalisés

Comment ça fonctionne

De zéro à la surveillance automatisée en quatre étapes

Aucune installation de SDK requise. 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 Flux XML (pour les rapports). Restreignez l’accès par adresse IP si vous le souhaitez.

Authentifier

Chaque requête s’authentifie auprès de votre intégration. Les sessions expirent après 60 secondes d’inactivité, ce qui maintient 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

Faites un appel 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 renvoient du JSON structuré.

Automatisez partout

Intégrez l’API avec Terraform, Jenkins, GitHub Actions, Azure DevOps ou vos propres scripts. Déclenchez la mise en place de moniteurs lors du déploiement, importez des données de performance dans le BI ou déclenchez automatiquement une alerte en cas de violation de SLA.

Spécifications techniques

Deux APIs. Un compte. Contrôle total.

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

Web API (Config & Contrôle)

Gérez votre infrastructure de surveillance de manière 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 de 60s)

Contrôle d’accès

Liste blanche IP optionnelle

Prend en charge

Méthodes 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 les données de surveillance en temps réel vers tout ce qui supporte XML.

URL de base

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

Protocoles

HTTP, HTTPS

Format de la requête

HTTP(S) GET avec paramètres URL

Format de la réponse

Document XML

Authentification

UID de compte (PID), généré comme une intégration XML Feed

Portée

Au niveau du compte 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 temporelle des 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 besoin de SDK.

Chaque objet de surveillance — appareils, tâches, alertes, groupes, plannings — est représenté comme une ressource JSON. Voici à quoi ressemble la récupération des données de surveillance depuis XRS et la création d’un nouvel appareil via l’API Web. Intégrez-les dans un curl, un script bash, un job Python ou une étape CI — peu importe 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 la surveillance — prêts à être affichés dans toute vue waterfall.

# Récupérer le 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 (trimmée)
<Response>
  <ID>3424533543</ID>
  <Name>API de paiement</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": "API de paiement — 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 forfait payant inclut un accès complet à l’API Web et XRS — pas de modules complémentaires, pas de facturation à la requête, pas de paliers de facturation supplémentaires.

Cas d'utilisation

Ce que les équipes construisent avec l'API

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

Surveillance en tant que code

Versionnez chaque moniteur avec le service qu’il protège. Provisionnez, mettez à jour et retirez des dispositifs via votre pipeline Terraform ou Pulumi existant — sans décalage entre la mise en scène et la production.

Tests de fumée post-déploiement

Déclenchez des vérifications HTTPS et des transactions multi-étapes à la demande depuis Jenkins, GitHub Actions ou Azure DevOps après chaque déploiement. Échouez la compilation lorsqu’une nouvelle version casse un point de terminaison critique.

Pages de statut personnalisées & tableaux de bord

Alimentez les données XRS dans des pages de disponibilité client, des affichages internes NOC ou des rapports SLA pour la direction. Sélectionnez uniquement les champs souhaités, formatés exactement comme vous en avez besoin.

Preuves SLA & rapports de conformité

Automatisez les exportations mensuelles SLA (pourcentage de disponibilité, temps de réponse P95 / P99, incidents d’indisponibilité) directement de XRS vers Excel ou PDF — documentées, horodatées et prêtes pour l’audit.

Provisionnement en masse de dispositifs

Déployez des centaines de moniteurs en une seule fois après une acquisition, une migration ou un basculement CDN. Dupliquez les modèles d’appareils existants et assignez les bons groupes, plannings et itinéraires d’alerte à grande échelle.

Intégration de tableaux de bord tiers

Injectez les données de surveillance dans Grafana, Power BI, Tableau ou Datadog avec votre autre télémétrie — vérifications synthétiques externes corrélées aux traces APM internes.

Gestion multi-locataires de comptes

Les MSP et équipes d’entreprise peuvent gérer des centaines de départements et des milliers d’appareils en une seule opération programmée, avec des flux XRS spécifiques à chaque département client.

Enrichissement d'incidents

Lorsqu’un moniteur déclenche, récupérez la cascade, le chiffrement et le détail du timing via XRS et joignez-les automatiquement à l’incident PagerDuty ou ServiceNow — réduisant ainsi le temps de triage.

Analyse Approfondie XRS

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

Le Service de Reporting XML 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 réussite. Ne retournez que les champs qui vous intéressent.

Type de rapport	Ce que vous obtenez	Usage typique
Utilisation du compte	Ressources utilisées et disponibles par solution de surveillance	Planification des licences et capacités, réconciliation de facturation
État de l’appareil	État courant et statut des appareils individuels ou groupes	Pages de statut en direct, tableaux de bord muraux NOC
Détails de la réponse	Timing et contenu par requête hautement personnalisables	Diagnostics détaillés, cascades personnalisées, enrichissement d’incidents
Configuration de l’appareil et des tâches	Captures de configuration de la surveillance exportées	Sauvegardes, clonage inter-environnements, pistes d’audit
Données résumées	Temps de disponibilité, temps d’arrêt, nombre de succès, 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
Aggrégats horaires	Données de réponse regroupées en fenêtres de 1 heure	Identification des pics de charge, analyse des tendances horaires
Aggré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, rapports de performance annuelle (YoY)
Statistiques sur 3 mois	Données statistiques calculées sur une fenêtre roulante de 3 mois	Alertes dérivées des baselines, détection d’anomalies

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

Pourquoi les équipes utilisent l’API

Conçu pour DevOps, SRE & Ingénierie plateforme

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

Éliminer la dérive

Gardez la configuration de la surveillance dans le contrôle de version. Appliquez les mêmes moniteurs dans différents 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 arrive avec le code, et non des semaines plus tard.

Échelle sans clics

Intégrez cent nouveaux domaines ou mille nouveaux points de terminaison avec un seul script. Pas de fatigue de clic.

Sécurité granulaire

Des sessions de courte durée, une liste blanche IP optionnelle et des clés d’intégration limitées au département maintiennent un accès strict.

S'adapte à Toute Stack

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

Gardez le Contrôle de 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 API unique couvre la surveillance et les tests de charge LoadView — pas d’outil séparé, pas d’identifiants distincts.

Sans Coût Supplémentaire

L’accès 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 de performance 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 via une seule interface et plateforme. Cela nous a permis d'opérer plus efficacement."

Gregory S.

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

Prêt à Mettre Votre Surveillance en Pilote Automatique ?

Chaque essai de 30 jours inclut un accès complet à l’API Web et à XRS — ainsi que toutes les solutions de surveillance, tous les emplacements et toutes les intégrations. Découvrez ce qu’est la surveillance automatisée.

Questions Fréquemment Posées

Questions Courantes sur l'API Dotcom-Monitor

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

Le Web API (config_api_v1) est une interface REST basée sur JSON pour créer et gérer la configuration de surveillance — appareils, tâches, groupes, horaires, alertes et tests de charge. Le Service de Rapport 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 : Web API pour la configuration, XRS pour extraire les résultats.

Comment m’authentifier à l’API ?

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

Quels formats de données sont pris en charge ?

Le Web API est entièrement JSON — aussi bien pour les corps de requête que pour 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 simplement une URL avec des paramètres de requête.

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

Le Web API 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, Port TCP, Traceroute, VoIP, et plus). Il couvre également toute la surface de test de charge LoadView.

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

L’accès à l’API et à XRS est inclus dans tous les plans payants — il n’y a pas de comptage par appel ni de frais supplémentaires. Les sessions expirent après 60 secondes d’inactivité, ce qui limite naturellement les scripts à longue exécution. Si vous avez besoin d’un accès restreint par IP ou d’un débit de niveau entreprise, contactez le service commercial pour les options Enterprise.

Jusqu’à quelle période puis-je extraire les données historiques via XRS ?

XRS peut retourner les données brutes de réponse jusqu’à 6 mois en arrière. Des rapports synthétiques et statistiques (agré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 pouvant effectuer un appel HTTP peut utiliser l’API. Les équipes intègrent couramment Jenkins, GitHub Actions, GitLab CI, Azure DevOps, CircleCI et Terraform pour provisionner des moniteurs lors des déploiements, exécuter des tests de fumée post-release, et contrôler les déploiements en production en fonction de la santé de la surveillance.

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

Oui. Lorsque vous créez 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. Consultez l’article Comment autoriser les IP pour l’accès Web API dans la base de connaissances pour plus de détails.

L’API prend-elle en charge les comptes multi-départements ou MSP ?

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

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 modèles de code prêts à l’emploi sont disponibles dans la section Exemples de code.

Automatisez la Surveillance.Récupérez du temps pour l’ingénierie.

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

Automatisez chaque partie de votre surveillance avec l'API Dotcom-Monitor

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

API Web — Référence Rapide

XRS — Référence Rapide

Générer une clé

Configurer

Surveiller

Extraire

Tout ce que l'IU peut faire — en code

Configuration complète du moniteur

Gestion des appareils, tâches et groupes

Emplacements et horaires

Alertes et intégrations de notifications

Flux de rapports en temps réel XRS

De zéro à la surveillance automatisée en quatre étapes

Créer une intégration

Authentifier

Envoyer des requêtes JSON

Automatisez partout

Deux APIs. Un compte. Contrôle total.

Web API (Config & Contrôle)

Service de rapport XML (XRS)

HTTP simple. Pas besoin de SDK.

Commencez à automatiser votre surveillance en 5 minutes

Ce que les équipes construisent avec l'API

Surveillance en tant que code

Tests de fumée post-déploiement

Pages de statut personnalisées & tableaux de bord

Preuves SLA & rapports de conformité

Provisionnement en masse de dispositifs

Intégration de tableaux de bord tiers

Gestion multi-locataires de comptes

Enrichissement d'incidents

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

Conçu pour DevOps, SRE & Ingénierie plateforme

Éliminer la dérive

Déplacer la surveillance à gauche

Échelle sans clics

Sécurité granulaire

S'adapte à Toute Stack

Gardez le Contrôle de Vos Données

Surface Unifiée

Sans Coût Supplémentaire

Ce Que Disent Nos Clients

Prêt à Mettre Votre Surveillance en Pilote Automatique ?

Questions Courantes sur l'API Dotcom-Monitor

Automatisez la Surveillance.Récupérez du temps pour l’ingénierie.

HTTP simple.
Pas besoin de SDK.