Home » Fonctionnalités » API
  • API Web REST
  • JSON
  • Service de Rapport XML
  • Webhooks
  • Prêt pour CI/CD

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

Créez des moniteurs de manière programmatique, gérez les appareils et les tâches, orchestrez les 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 API Web REST documentée et le Service de Rapport XML (XRS).
Commencez Votre Essai Gratuit de 30 Jours
Planifiez une Démo
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.
  • Aucune carte de crédit requise
  • Installation en moins de 5 minutes
  • Accès complet à l’API inclus dans tous les plans payants
  • Support expert 24×7
10 000+

Organisations dans le Monde

99,99%

SLA de Disponibilité de la Plateforme

30+

Sites de Surveillance Globaux

Depuis 1998

Leader de la Surveillance de Sites Web

Surveillance Programmatique

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 : le Web API basé sur REST pour la configuration et le Service de Reporting XML (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 en tant que code, intégrer la surveillance dans vos outils de ticketing existants, ou incorporer des données de performance en direct dans des pages de statut orientées client.

Le Service de Reporting XML (XRS) est un flux de données gratuit à la demande qui retourne les résultats de surveillance sous forme de documents XML. Orientez-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 l’ingénierie.

Ensemble, ils donnent à vos équipes plateforme, SRE et DevOps un contrôle programmatique complet — sans clics d’interface utilisateur nécessaires.

  • Configurer des moniteurs HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView, and 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 toute chaîne HTTP-capable

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)

Authentification

Par requête, session de 60 secondes ; liste blanche d’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 remontant jusqu’à 6 mois

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

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

Surveiller

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

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'interface peut faire — en code

Chaque objet de surveillance dans votre compte est une ressource API de premier ordre. 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 les appareils BrowserView, UserView, ServerView et MetricsView
  • Ajouter l'authentification : OAuth 2.0, clés API, jetons Bearer, Basic, NTLM, mTLS
  • Définir les assertions JSONPath / XPath et la validation personnalisée de réponses

Gestion des appareils, tâches et groupes

  • Fournir des appareils et les tâches qui leur sont associées
  • Organiser les moniteurs en groupes avec alertes et filtres hérités
  • Appliquer des changements de configuration en masse à travers les environnements
  • Cloner des appareils entre les comptes de staging, QA et production

Emplacements & Horaires

  • Lister chaque emplacement de surveillance global disponible
  • Attribuer des contrôles à des régions spécifiques ou à vos Agents Privés
  • Créer des plannings basés sur le temps (heures ouvrables, fenêtres de maintenance)
  • Appliquer des filtres de façon programmée pour supprimer le bruit connu

Alertes & Intégrations de Notification

  • Créer, mettre à jour, et acheminer des groupes d'alerte via API
  • Gérer les listes de destinataires, les politiques d'escalade, et les rotations d'astreinte
  • Envoyer des notifications sur Slack, PagerDuty, Teams, OpsGenie, webhooks
  • Automatiser le réglage des escalades sans toucher à l'interface

Flux de Reporting en Temps Réel XRS

  • Récupérer des 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, planning, succès / échec, département
  • Diffuser dans SQL, Excel, Power BI, Grafana, ou tableaux de bord personnalisés
Comment Ça Marche

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

Aucune installation de SDK requise. Si votre système peut faire une requête HTTP, il peut communiquer avec Dotcom-Monitor.

01

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 le reporting). Restreignez l’accès par adresse IP en option.

02

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 à courte durée et sécurisé. Les requêtes XRS utilisent votre UID de compte généré (PID).

03

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

04

Automatisez Partout

Intégrez l’API dans Terraform, Jenkins, GitHub Actions, Azure DevOps ou vos propres scripts. Déclenchez le provisionnement de moniteurs lors du déploiement, récupérez les données de performance dans votre BI ou auto-alertez lors de violations SLA.

Spécifications Techniques

Deux APIs. Un Compte. Contrôle Total.

L’API Web gère la configuration ; XRS gère le reporting. Elles 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 requête

JSON (application/json)

Format de 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 d’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 reporting XML (XRS)

Diffusez les données de monitoring en temps réel dans tout ce qui utilise XML.

URL de base

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

Protocoles

HTTP, HTTPS

Format de requête

GET HTTP(S) avec paramètres URL

Format de réponse

Document XML

Authentification

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

Périmètre

À l’échelle 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 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-les dans un curl, un script bash, un job Python ou une étape CI — 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 utilisé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 (tronqué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 forfait 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.

Commencez Votre Essai Gratuit de 30 Jours
Planifiez une Démo
  • Aucune carte de crédit requise
  • Annulez à tout moment
  • Support expert 24×7
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 les flux de travail qu’ils utilisent déjà.

Surveillance en tant que code

Versionnez chaque moniteur en même temps que le service qu’il protège. Provisions, mettez à jour et retirez des appareils 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 contrôles HTTPS et de transactions multi-étapes à la demande 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 et tableaux de bord

Alimentez les pages de disponibilité destinées aux clients, les affichages NOC internes ou les rapports SLA exécutifs avec les données XRS. Sélectionnez uniquement les champs souhaités, formatés exactement comme vous en avez besoin.

Preuves SLA & rapport de conformité

Automatisez les exports mensuels SLA (pourcentage de disponibilité, temps de réponse P95 / P99, incidents de panne) directement depuis XRS vers Excel ou PDF — documentés, horodatés et prêts 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 de CDN. Clonez les modèles d’appareils existants et assignez les bons groupes, horaires et routes 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 — contrôles synthétiques externes corrélés aux traces APM internes.

Gestion multi-locataires

Les MSP et les équipes d’entreprise peuvent gérer des centaines de départements et des milliers d’appareils en une seule action programmatique, avec des flux XRS spécifiques par département pour chaque client.

Enrichissement des incidents

Lorsqu’un moniteur se déclenche, récupérez la waterfall, le cipher et la ventilation des temps via XRS et attachez-les automatiquement à l’incident PagerDuty ou ServiceNow — réduisant 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écapitulatives ou des réponses brutes. Filtrez par emplacement, horaire ou état de réussite. Retournez uniquement 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, rapprochement de facturation
Statut de l’appareil
État et statut actuels des appareils individuels ou des ensembles
Pages de statut en direct, tableaux de bord muraux NOC
Détails de la réponse
Minuteries et contenu hautement personnalisables par requête
Diagnostics détaillés, cascades personnalisées, enrichissement des incidents
Configuration des appareils et des tâches
Instantanés de configuration de surveillance exportés
Sauvegardes, clonage inter-environnements, pistes d’audit
Données récapitulatives
Temps de disponibilité, temps d’indisponibilité, 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
Revues opérationnelles quotidiennes, comparaisons jour ouvré vs week-end
Hebdomadaire / mensuel / annuel
Résumés 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 période 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, département 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

Gardez la configuration de la surveillance dans le contrôle de version. Appliquez les mêmes moniteurs sur plusieurs 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 est déployée 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 des clics.

Sécurité granulaire

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

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.

Proprenez vos données

Récupérez 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 englobe la surveillance et les tests 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 nos clients disent

"L'une des meilleures fonctionnalités de Dotcom est la capacité de push/pull de l'API 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 de fonctionner 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 que donne la surveillance automatisée.

Commencer l'essai gratuit
Lire la documentation de l'API
  • Installation en moins de 5 minutes
  • Aucune carte de crédit requise
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, plannings, alertes, et tests de charge. Le XML Reporting Service (XRS) est un flux séparé gratuit qui renvoie les résultats de surveillance au format XML via HTTP GET. La plupart des équipes utilisent les deux : l’API Web pour configurer, le 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 le UID du compte généré comme paramètre PID dans l’URL. Vous pouvez également restreindre l’accès par adresse IP.

Le Web API est entièrement JSON — corps de requête et 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 protocoles (DNS, SSL, Email, FTP, ICMP Ping, Port TCP, Traceroute, VoIP, et plus). Il couvre également toute la surface de test de charge LoadView.

L’accès API et XRS est inclus dans tous les plans payants — il n’y a pas de facturation par appel ni de frais supplémentaires. Les sessions expirent après 60 secondes d’inactivité, ce qui limite naturellement les scripts longs. 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 Entreprise.

XRS peut retourner des données de réponse brutes jusqu’aux 6 derniers mois. Des rapports récapitulatifs 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.

Oui — tout outil capable d’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 du déploiement, exécuter des tests de fumée post-lancement et contrôler les déploiements en production selon l’état 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 de confiance. 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 root peuvent gérer les départements de manière programmatique, et une intégration par flux XML peut être limitée à des départements spécifiques. Les utilisateurs limités à un département peuvent uniquement extraire les rapports XRS pour leur propre département, ce qui assure une séparation propre pour les MSP et les configurations multi-locataires.

La documentation complète se trouve dans la base de connaissances Dotcom-Monitor, y compris le guide Prise en main de l’API, les références des méthodes Monitoring et LoadView avec 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 d'ingénierie.

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

Essai gratuit — Sans carte de crédit
Voir les tarifs
  • Essai complet de 30 jours
  • Plan gratuit disponible
  • Annulez à tout moment