Autenticación

Todas las solicitudes API requieren autenticación mediante una clave API. Esta guía cubre cómo generar, usar y gestionar tus claves API.

Generar claves API

1. Ve a Configuración → "Claves API" en tu panel.
2. Haz clic en "Generar nueva clave".
3. Dale un nombre a la clave (p. ej., "Producción", "Desarrollo").
4. Copia la clave inmediatamente — no se mostrará de nuevo.

Usar tu clave API

Incluye tu clave API en el encabezado Authorization de cada solicitud:

Authorization: Bearer YOUR_API_KEY

Ejemplo con cURL:

curl -X GET https://api.bhomy.ai/v1/agents \
  -H "Authorization: Bearer bhy_abc123def456" \
  -H "Content-Type: application/json"

Ejemplo con JavaScript:

const response = await fetch('https://api.bhomy.ai/v1/agents', {
  headers: {
    'Authorization': 'Bearer bhy_abc123def456',
    'Content-Type': 'application/json'
  }
});
const agents = await response.json();

Ejemplo con Python:

import requests

headers = {
    'Authorization': 'Bearer bhy_abc123def456',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.bhomy.ai/v1/agents', headers=headers)
agents = response.json()

Límites de tasa

La información del límite de tasa se incluye en los encabezados de respuesta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Gestión de claves

Puedes tener múltiples claves API para diferentes entornos. Rota las claves regularmente generando una nueva y revocando la antigua. Las claves revocadas dejan de funcionar inmediatamente.