Autenticación

Resumen

API Keys

Tu API Key identifica tu negocio y debe incluirse en todas las peticiones a la API.

Obtener tu API Key

1. Inicia sesión en tu Dashboard
2. Ve a Configuración → Integraciones
3. Haz clic en Generar Nueva API Key
4. Asigna un nombre descriptivo (ej: "Widget Web", "App Móvil")
5. Copia y guarda la API Key de forma segura

Usar la API Key

Incluye tu API Key en el header X-API-Key de cada petición:

curl -X GET "https://app.salonbookit.com/api/v1/negocio/" \
  -H "X-API-Key: hh_pub_live_abc123def456..."

const response = await fetch('https://app.salonbookit.com/api/v1/servicios/', {
    headers: {
        'X-API-Key': 'hh_pub_live_abc123def456...'
    }
});
const data = await response.json();

import requests

response = requests.get(
    'https://app.salonbookit.com/api/v1/servicios/',
    headers={'X-API-Key': 'hh_pub_live_abc123def456...'}
)
data = response.json()

$ch = curl_init('https://app.salonbookit.com/api/v1/servicios/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: hh_pub_live_abc123def456...'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

Tipos de API Key

Las API Keys tienen dos dimensiones: tipo (pública/privada) y entorno (producción/pruebas).

Por tipo

Por entorno

Ejemplos de formatos completos:

• hh_pub_live_... - Pública de producción (para widgets en producción)
• hh_pub_test_... - Pública de pruebas (para desarrollo de widgets)
• hh_sec_live_... - Privada de producción (para tu backend)
• hh_sec_test_... - Privada de pruebas (para desarrollo backend)

Autenticación JWT

Los endpoints que requieren autenticación de cliente utilizan tokens JWT. Estos endpoints incluyen:

• Ver reservas del cliente
• Ver/modificar perfil del cliente
• Consultar puntos de fidelidad
• Ver historial de pedidos

Obtener un token JWT

Request

curl -X POST "https://app.salonbookit.com/api/v1/auth/login/" \
  -H "X-API-Key: hh_pub_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "cliente@ejemplo.com",
    "password": "contraseña123"
  }'

Response (200 OK) - Cliente

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "tipo": "cliente",
    "cliente": {
      "id": 123,
      "nombre": "Juan",
      "apellido": "García",
      "email": "cliente@ejemplo.com",
      "telefono": "+34612345678",
      "puntos": 150,
      "nivel": "gold"
    }
  }
}

Response (200 OK) - Staff

Si las credenciales corresponden a un miembro del staff:

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "tipo": "staff",
    "staff": {
      "id": 1,
      "nombre": "María",
      "apellido": "López",
      "email": "maria@salon.com",
      "telefono": "+34612345678",
      "rol": "admin",
      "permisos": {
        "puede_ver_reservas": true,
        "puede_crear_reservas": true,
        "puede_ver_clientes": true
      }
    }
  }
}

Usar el token JWT

Incluye el token en el header Authorization con el prefijo Bearer:

curl -X GET "https://app.salonbookit.com/api/v1/cliente/reservas/" \
  -H "X-API-Key: hh_pub_live_abc123..." \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Renovar el token

Los tokens expiran en 24 horas. Usa el endpoint de refresh para obtener uno nuevo:

curl -X POST "https://app.salonbookit.com/api/v1/auth/refresh/" \
  -H "X-API-Key: hh_pub_live_abc123..." \
  -H "Authorization: Bearer TOKEN_ACTUAL"

Rate Limiting

La API tiene límites de peticiones para garantizar un servicio estable:

Headers de Rate Limit

Cada respuesta incluye headers informativos:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
X-RateLimit-Reset: 1704067200

Error 429: Too Many Requests

Si excedes el límite, recibirás un error 429:

{
  "success": false,
  "error": "Has excedido el límite de requests. Intenta de nuevo en 45 segundos.",
  "code": "RATE_LIMIT_EXCEEDED"
}

Errores de autenticación