Autenticación

La API de Beel utiliza API Keys para autenticación. Todos los endpoints requieren autenticación para garantizar la seguridad de tus datos de facturación.

API Key

Para realizar peticiones a la API, necesitarás tu API Key. Aquí tienes cómo añadir la API Key al header de la petición usando cURL:

curl https://app.beel.es/api/v1/facturas \
  -H "X-API-Key: beel_sk_xxx"

Formato de API Keys

Las API Keys de Beel siguen un formato que indica el entorno:

• Sandbox (pruebas): beel_sk_test_<identificador>
• Producción: beel_sk_live_<identificador>

La URL base es la misma para ambos entornos (https://app.beel.es/api/v1). La API Key determina automáticamente en qué entorno se ejecutan las operaciones.

Obtener tu API Key

Las API Keys se crean y gestionan desde el panel de control de Beel:

1. Accede a app.beel.es
2. Ve a Ajustes → API Keys
3. Haz clic en Crear clave API
4. Selecciona el entorno (sandbox o producción)
5. Copia la clave generada (solo se muestra una vez)

Seguridad

Importante:

• Mantén siempre tu API Key segura y no la compartas
• No incluyas la API Key en código público o repositorios
• Regenera la API Key si sospechas que ha sido comprometida
• Usa variables de entorno para almacenar las API Keys

# Ejemplo usando variable de entorno
export BEEL_API_KEY="beel_sk_live_xxx"

curl https://app.beel.es/api/v1/facturas \
  -H "X-API-Key: $BEEL_API_KEY"

Errores de autenticación

Si la autenticación falla, recibirás una respuesta con código de estado 401:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API Key inválida o faltante"
  }
}