Références sur les API

L’API Datadog est une API HTTP REST. Elle utilise des URL orientées ressources pour appeler l’API, applique des codes de statut afin d’indiquer la réussite ou l’échec des requêtes, renvoie un objet JSON à partir de toutes les requêtes et tire profit des codes de réponse HTTP standard. Utilisez l’API Datadog pour accéder à la plateforme Datadog par programmation.

Prise en main

Authentifiez-vous auprès de l’API avec une clé d’API en utilisant l’en-tête DD-API-KEY. Pour certains endpoints, vous devez également utiliser une clé d’application, qui repose sur l’en-tête DD-APPLICATION-KEY.

Pour essayer l’API

La section Utiliser l’API présente le fonctionnement des endpoints.

Remarque : les exemples de code cURL supposent que vous utilisiez les coreutils GNU et BASH. Sous macOS, vous pouvez installer coreutils via le gestionnaire de packages Homebrew : brew install coreutils.

Bibliothèques client

Par défaut, la documentation dédiée à l’API Datadog propose des exemples en cURL. Sélectionnez l’une de nos bibliothèques client officielles dans chaque endpoint pour voir des exemples de code pour cette bibliothèque. Pour installer chaque bibliothèque :

Installation

Maven - Ajoutez cette dépendance au fichier POM de votre projet :

<dependency>
  <groupId>com.datadoghq</groupId>
  <artifactId>datadog-api-client</artifactId>
  <version>2.33.1</version>
  <scope>compile</scope>
</dependency>

Gradle - Ajoutez cette dépendance au fichier de build de votre projet :

compile "com.datadoghq:datadog-api-client:2.33.1"

Utilisation

import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.Configuration;
import com.datadog.api.<VERSION>.client.api.*;
import com.datadog.api.<VERSION>.client.model.*;

Remarque : remplacez <VERSION> par v1 ou v2 en fonction des endpoints que vous souhaitez utiliser.

Exemples

pom.xml Maven pour les exemples en cours d’exécution :

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>example</artifactId>
  <version>1</version>
  <dependencies>
    <dependency>
      <groupId>com.datadoghq</groupId>
      <artifactId>datadog-api-client</artifactId>
      <version>2.33.1</version>
      <scope>compile</scope>
    </dependency>
  </dependencies>
</project>

Assurez-vous que la variable CLASSPATH contienne toutes les dépendances.

export CLASSPATH=$(mvn -q exec:exec -Dexec.executable=echo -Dexec.args="%classpath")

build.gradle Gradle pour les exemples en cours d’exécution :

plugins {
    id 'java'
    id 'application'
}

repositories {
    jcenter()
}

dependencies {
    implementation 'com.datadoghq:datadog-api-client:2.33.1'
}

application {
    mainClassName = 'Example.java'
}