Solicita acceso anticipado

Indica tu nombre y un email o número de teléfono. Nos pondremos en contacto contigo para darte los detalles de acceso a Tajo.

En esta página

Tu primera llamada a la API

Vamos a hacer tu primera llamada a la API para comprobar que tu configuración de la API de Brevo funciona correctamente.

Requisitos previos

Una cuenta de Brevo
Una clave de API de tu panel de control
Una herramienta para hacer solicitudes HTTP (curl, Postman o similar)

Consulta la información de tu cuenta

La primera llamada más sencilla consiste en consultar la información de tu cuenta:

Con cURL

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('Account Info:', data);
  } catch (error) {
    console.error('Error:', 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;
?>

Respuesta esperada

Si todo va bien, recibirás una respuesta como esta:

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

Gestión de errores

Si encuentras errores, revisa estos problemas habituales:

Clave de API no válida (401 Unauthorized)

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

Solución: comprueba que tu clave de API es correcta y tiene los permisos adecuados.

Límite de tasa superado (429 Too Many Requests)

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

Solución: espera antes de hacer otra solicitud o mejora tu plan.

Error del servidor (500 Internal Server Error)

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

Solución: consulta nuestra página de estado o contacta con el soporte.

Próximos pasos

Ahora que ya has hecho tu primera llamada correcta a la API:

Configura la autenticación como es debido
Instala un SDK para tu lenguaje
Conoce los límites de tasa
Explora los endpoints de email