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

Créez des moniteurs programmatiquement, gérez les appareils et les tâches, orchestrez des tests de charge, et diffusez des données de performance en temps réel dans vos propres tableaux de bord, SIEMs, et pipelines CI/CD — avec une REST Web API documentée et le Service de rapport XML (XRS).
Three floating dark-mode cards on a deep navy background — a Web API JSON request creating a new HTTPS monitor, an XRS XML response with a timing breakdown, and a live API-surface KPI panel showing requests, devices, locations, sessions, and last deploy.
10 000+

Organisations dans le monde

99,99 %

SLA de disponibilité de la plateforme

30+

Sites mondiaux de surveillance

Depuis 1998

Leader de la surveillance de sites 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 — peut être réalisé programmatiquement via deux services complémentaires : l’API Web basée sur 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 sous configuration-as-code, intégrer la surveillance dans 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 Service de Reporting XML (XRS) est un flux de données à la demande gratuit qui renvoie 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 dépendre des ingénieurs.

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

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

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

Authentification

UID du 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

1

Générer une clé

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

2

Configurer

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

Surveiller

Exécute depuis plus de 30 emplacements mondiaux selon votre planning défini.
4

Extraire

Extraire les résultats via XRS vers des tableaux de bord, BI, Excel, ou 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

Gestion des appareils, des tâches et des groupes

Emplacements et plannings

Alertes et intégrations de notification

Flux de rapports en temps réel XRS

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.

01

Créez 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 le reporting). Restreignez éventuellement l’accès par adresse IP.

02

Authentifiez-vous

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

03

Envoyez des requêtes JSON

Appelez 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 un JSON structuré.

04

Automatisez partout

Connectez l’API à Terraform, Jenkins, GitHub Actions, Azure DevOps ou vos propres scripts. Déclenchez la provision de moniteurs au déploiement, récupérez les données de performances dans la BI ou envoyez automatiquement des alertes en cas de violation de SLA.

Spécifications techniques

Deux API. Un compte. Contrôle total.

Le Web API gère la configuration ; XRS gère le reporting. 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 (temporisation de 60s)

Contrôle d’accès

Liste blanche IP optionnelle

Couvre

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 des données de surveillance en temps réel vers tout système compatible 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é en tant qu’intégration XML Feed

Périmètre

À l’échelle du compte ou limité à certains départements

Types de rapports

Configuration de l’appareil, état, 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, réussite / é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 de données de surveillance de 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 — quel que soit l’outil déjà utilisé par votre équipe.

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êt à être inséré 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 (extrait)
<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 — sans add-ons, sans facturation à la requête, sans 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à.

Surveillance-en-Code

Versionnez chaque moniteur avec le service qu’il protège. Provisionnez, mettez à jour, et retirez les dispositifs via votre pipeline Terraform ou Pulumi existant — sans dérive entre staging et production.

Tests de fumée post-déploiement

Déclenchez des contrôles HTTPS à la demande et des transactions en plusieurs étapes depuis Jenkins, GitHub Actions ou Azure DevOps après chaque déploiement. Échouez la build 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 NOC internes ou des rapports d’exécution SLA pour les dirigeants. Récupérez uniquement les champs souhaités, formatés exactement comme vous en avez besoin.

Preuves SLA & rapports de conformité

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

Provisionnement en masse des dispositifs

Lancez des centaines de moniteurs en une seule opération après une acquisition, une migration ou une bascule CDN. Clonez les modèles de dispositifs existants et assignez à grande échelle groupes, horaires et routes d’alerte appropriés.

Intégration de tableaux de bord tiers

Injectez 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 traces APM internes.

Gestion de comptes multi-locataires

Les MSP et équipes d’entreprise peuvent gérer des centaines de départements et des milliers de dispositifs en une seule opération programmable, avec des flux XRS limités à chaque département pour chaque client.

Enrichissement des incidents

Lorsqu’un moniteur se déclenche, récupérez automatiquement la cascade, le chiffrement et la ventilation du timing via XRS et joignez-les à 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 rapports XML est un flux flexible, gratuit et à la demande. Demandez des données de synthèse ou des réponses brutes. Filtrez par emplacement, planning ou état de réussite. Ne renvoyez que 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 capacités, rapprochement de facturation
Statut 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 des réponses
Chronométrage et contenu hautement personnalisables par requête
Diagnostics détaillés, cascades personnalisées, enrichissement d’incident
Configuration des appareils et des tâches
Instantanés de configuration de surveillance exportés
Sauvegardes, clonage inter-environnements, pistes d’audit
Données de synthèse
Temps de disponibilité, temps d’arrêt, nombre de succès, nombre d’échecs, performance, écart type
Résumés exécutifs, rapports SLA
Réponses brutes
Chaque résultat de contrôle 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 d’une 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
Revue des opérations quotidiennes, comparaisons jour ouvrable vs week-end
Hebdomadaire / mensuel / annuel
Résumés sur des horizons temporels plus longs
Tendances au niveau du conseil, rapports de performance annuels
Statistiques sur 3 mois
Données statistiques calculées sur une fenêtre glissante de 3 mois
Alertes basées sur 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, département et plage de dates personnalisée.

Pourquoi les équipes utilisent l'API

Conçu pour DevOps, SRE et l'ingénierie des plateformes

L’API Dotcom-Monitor élimine les clics manuels de l’interface utilisateur 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 à travers les environnements en toute confiance.

Déplacer la surveillance vers la gauche

Ajoutez des contrôles synthétiques dans la même PR que le service qu’ils couvrent. La surveillance arrive avec 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 liée aux clics.

Sécurité granulaire

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

Convient à Toute Pile

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

Possédez Vos Données

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

Surface Unifiée

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

Sans Coût Supplémentaire

L’accès API et XRS est inclus avec chaque forfait payant. Pas de tarification par appel, pas de surcoût pour l’automatisation.

Ce Que Disent Nos Clients

"Une des meilleures fonctionnalités de Dotcom est la capacité d'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 au sein d'une seule interface et plateforme. Cela nous a permis d'opérer plus efficacement."
Gregory S.
Manager, Broadcast Media · Avis vérifié sur 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 que donne la surveillance automatisée.

Questions Fréquemment Posées

Questions Courantes sur l'API Dotcom-Monitor

Le Web API (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 distinct qui renvoie les résultats de 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.

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 URL PID. Vous pouvez également restreindre l’accès par adresse IP.

Le Web API est entièrement JSON — tant les corps des requêtes que 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.

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

L’accès à l’API et à XRS est inclus dans tous les plans payants — il n’y a pas de mesure par appel et pas de frais supplémentaire. Les sessions expirent après 60 secondes d’inactivité, ce qui limite naturellement les scripts long-courriers. Si vous avez besoin d’un accès restreint par IP ou d’un débit de niveau entreprise, contactez les Ventes pour les options Entreprise.

XRS peut renvoyer des données brutes de réponse pour jusqu’à 6 mois en arrière. Des rapports de synthèse et statistiques (agrégats horaires / quotidiens / hebdomadaires / mensuels / annuels et statistiques sur 3 mois) sont disponibles sur des horizons plus longs. Vous spécifiez la date/heure de début et de fin pour chaque rapport.

Oui — tout outil pouvant 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 des déploiements, exécuter des tests rapides post-release, et contrôler les déploiements en production en fonction de la santé de la surveillance.

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 approuvées. Voir l’article Comment autoriser des IP pour l’accès Web API dans la Base de Connaissances pour plus de détails.

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

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 de Monitoring et LoadView avec exemples JSON, ainsi que 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.Reprenez du temps pour l’ingénierie.

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