Autenticacion

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 sesion en tu Dashboard
2. Ve a Configuracion → Integraciones
3. Haz clic en Generar Nueva API Key
4. Asigna un nombre descriptivo (ej: "Widget Web", "App Movil")
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 peticion:

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

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

import requests

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

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

Tipos de API Key

Autenticacion JWT

Los endpoints que requieren autenticacion 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_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "cliente@ejemplo.com",
    "password": "contraseña123"
  }'

Response (200 OK)

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "cliente": {
      "id": 123,
      "nombre": "Juan Garcia",
      "email": "cliente@ejemplo.com",
      "telefono": "+34612345678"
    },
    "expires_in": 86400
  }
}

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_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_live_abc123..." \
  -H "Authorization: Bearer TOKEN_ACTUAL"

Rate Limiting

La API tiene limites 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 limite, recibiras un error 429:

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

Errores de autenticacion