On this page

Prima chiamata API

Effettuiamo la tua prima chiamata API per verificare che la configurazione dell’API Brevo funzioni correttamente.

Prerequisiti

  • Un account Brevo
  • Una chiave API dalla tua dashboard
  • Uno strumento per effettuare richieste HTTP (curl, Postman o simili)

Ottenere le informazioni dell’account

La chiamata più semplice è ottenere le informazioni del tuo account:

Con cURL

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

Con 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('Info account:', data);
  } catch (error) {
    console.error('Errore:', error);
  }
};


getAccount();

Con 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())

Con 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;
?>

Risposta attesa

In caso di successo, riceverai una risposta come questa:

{
  "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
    }
  ]
}

Gestione degli errori

Se riscontri errori, verifica questi problemi comuni:

Chiave API non valida (401 Unauthorized) 

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

Soluzione: Verifica che la tua chiave API sia corretta e abbia i permessi appropriati.

Limite di frequenza superato (429 Too Many Requests) 

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

Soluzione: Attendi prima di effettuare un’altra richiesta o passa a un piano superiore.

Errore del server (500 Internal Server Error) 

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

Soluzione: Controlla la nostra pagina di stato o contatta il supporto.

Prossimi passi

Ora che hai effettuato con successo la tua prima chiamata API:

  1. Configurare l’autenticazione correttamente
  2. Installare un SDK per il tuo linguaggio
  3. Scopri di più sui limiti di frequenza
  4. Esplora gli endpoint e-mail
Inizia gratis con Brevo