On this page

Premier appel API

Effectuons votre premier appel API pour vérifier que votre configuration de l’API Brevo fonctionne correctement.

Prérequis

Un compte Brevo
Une clé API depuis votre tableau de bord
Un outil pour effectuer des requêtes HTTP (curl, Postman ou similaire)

Obtenir les informations du compte

L’appel le plus simple est d’obtenir les informations de votre compte :

Avec cURL

curl -X GET "https://api.brevo.com/v3/account" \
  -H "Accept: application/json" \
  -H "api-key: YOUR_API_KEY"

Avec JavaScript (Node.js)

const fetch = require('node-fetch');

const getAccount = async () => {
  try {
    const response = await fetch('https://api.brevo.com/v3/account', {
      method: 'GET',
      headers: {
        'Accept': 'application/json',
        'api-key': 'YOUR_API_KEY'
      }
    });

    const data = await response.json();
    console.log('Infos du compte:', data);
  } catch (error) {
    console.error('Erreur:', error);
  }
};

getAccount();

Avec Python

import requests

url = "https://api.brevo.com/v3/account"
headers = {
    "Accept": "application/json",
    "api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Avec PHP

<?php
$url = 'https://api.brevo.com/v3/account';
$headers = [
    'Accept: application/json',
    'api-key: YOUR_API_KEY'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Réponse attendue

En cas de succès, vous recevrez une réponse comme celle-ci :

{
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Doe",
  "companyName": "Your Company",
  "address": {
    "street": "123 Main Street",
    "city": "New York",
    "zipCode": "10001",
    "country": "United States"
  },
  "plan": [
    {
      "type": "payAsYouGo",
      "credits": 10000,
      "creditsUsed": 1500
    }
  ]
}

Gestion des erreurs

Si vous rencontrez des erreurs, vérifiez ces problèmes courants :

Clé API invalide (401 Unauthorized)

{
  "code": "unauthorized",
  "message": "Invalid API key provided"
}

Solution : Vérifiez que votre clé API est correcte et dispose des permissions appropriées.

Limite de débit dépassée (429 Too Many Requests)

{
  "code": "too_many_requests",
  "message": "Rate limit exceeded"
}

Solution : Attendez avant d’effectuer une autre requête ou passez à un forfait supérieur.

Erreur serveur (500 Internal Server Error)

{
  "code": "internal_error",
  "message": "An internal error occurred"
}

Solution : Consultez notre page de statut ou contactez le support.

Prochaines étapes

Maintenant que vous avez effectué votre premier appel API avec succès :

Configurer l’authentification correctement
Installer un SDK pour votre langage
En savoir plus sur les limites de débit
Explorer les endpoints e-mail