API Statistics

Vue d’ensemble

L’API Statistics renvoie une liste des métriques de vos accords de niveau de service (SLA) et des informations générales pour chaque vérification de moniteur. Cette API reflète certaines informations figurant dans votre liste ou graphique de données simple.

Exemple d’utilisation

Utilisez la commande d’API Statistics pour obtenir des informations telles que l’objectif SLA, l’indisponibilité, le pourcentage de disponibilité et le nombre d’alertes de moniteur, d’erreurs et de vérifications.

Prérequis

Pour utiliser l’API Statistics, vous avez besoin des éléments suivants :

• Les identifiants de l’API d’Uptrends
• Une bonne connaissance de vos critères SLA et de la configuration de vos moniteurs

Endpoints de l’API Statistics

L’API Statistics fournit les endpoints suivants :

Pour en savoir plus sur les formats des requêtes et des réponses et la réalisation de tests interactifs, vous pouvez consulter la documentation de l’API Statistics d’Uptrends (en anglais).

Réponse de l’API Statistics

{
  "Data": [
    {
      "Id": "10/13/2025 8:00:00 PM",
      "Type": "Statistics",
      "Attributes": {
        "StartDateTime": "2025-10-13T20:00:00",
        "EndDateTime": "2025-10-13T21:00:00",
        "Alerts": 0,
        "OperatorResponseTarget": 15,
        "OperatorResponseTime": 0,
        "DowntimePercentage": 0,
        "UptimePercentage": 100,
        "Checks": 62,
        "ConfirmedErrors": 0,
        "UnconfirmedErrors": 0,
        "Uptime": 3590,
        "Downtime": 0,
        "TotalTime": 0.727,
        "ResolveTime": 0.106,
        "ConnectionTime": 0.092,
        "DownloadTime": 0.527,
        "TotalBytes": 5699
      },
      "Relationships": [
        {
          "Id": "6f426452-5d2b-4fdf-84e2-c2b3d7ebf918",
          "Type": "Monitor",
          "Links": {
            "Self": "/Monitor/6f426452-5d2b-4fdf-84e2-c2b3d7ebf918"
          }
        }
      ]
    },
    {
      "Id": "10/13/2025 9:00:00 PM",
      "Type": "Statistics",
      "Attributes": {
        "StartDateTime": "2025-10-13T21:00:00",
        "EndDateTime": "2025-10-13T22:00:00",
        "Alerts": 10,
        "OperatorResponseTarget": 15,
        "OperatorResponseTime": 0,
        "DowntimePercentage": 0,
        "UptimePercentage": 100,
        "Checks": 62,
        "ConfirmedErrors": 0,
        "UnconfirmedErrors": 0,
        "Uptime": 3601,
        "Downtime": 0,
        "TotalTime": 0.7,
        "ResolveTime": 0.089,
        "ConnectionTime": 0.097,
        "DownloadTime": 0.513,
        "TotalBytes": 5699
      },
      "Relationships": [
        {
          "Id": "6f426452-5d2b-4fdf-84e2-c2b3d7ebf918",
          "Type": "Monitor",
          "Links": {
            "Self": "/Monitor/6f426452-5d2b-4fdf-84e2-c2b3d7ebf918"
          }
        }
      ]
    }
    ...
  ]

}

Paramètres de l’API

Utilisez les paramètres suivants pour filtrer des informations dans la réponse de l’API :

Champs de l’API Statistics

L’API Statistics contient plusieurs champs :

Champ d’API Attributes

Le champ d’API Attributes contient :

Dépannage

Vous trouverez ci-dessous les erreurs HTTP les plus courantes et les étapes à suivre pour résoudre les problèmes liés à l’API Statistics.

Erreurs courantes

Codes de statut HTTP courants et leurs descriptions :

Dépannage général

Pensez à :

• Toujours valider les données de votre requête avant d’envoyer les appels d’API.
• Utiliser des méthodes HTTP appropriées pour chaque opération.

Pour en savoir plus, veuillez contacter notre équipe de support.

Articles liés

Pour en savoir plus, vous pouvez lire les articles suivants :

• Documentation de l’API Statistics d’Uptrends : cette documentation interactive vous fournit des spécifications détaillées sur les endpoints (en anglais).
• Journal de modification des API : cette page rassemble les dernières actualités sur l’API et les avis de retrait.