Authentifizierung

Zusammenfassung

API Keys

Ihr API-Schlüssel identifiziert Ihr Geschäft und muss in allen API-Anfragen enthalten sein.

Ihren API-Schlüssel erhalten

1. Melden Sie sich an bei Dashboard
2. Gehen Sie zu Konfiguration → Integrationen
3. Klicken Sie auf Neuen API-Schlüssel generieren
4. Asigna un nombre descriptivo (ej: "Widget Web", "App Móvil")
5. Kopieren und sicher speichern Sie den API-Schlüssel

API-Schlüssel verwenden

Fügen Sie Ihren API-Schlüssel im Header ein X-API-Key jeder Anfrage:

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);

Arten von API-Schlüsseln

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)

JWT-Authentifizierung

Endpoints, die Kundenauthentifizierung erfordern, verwenden JWT-Token. Diese Endpoints umfassen:

• Kundenbuchungen anzeigen
• Kundenprofil anzeigen/ändern
• Treuepunkte abfragen
• Bestellverlauf anzeigen

JWT-Token erhalten

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) - Kunde

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

JWT-Token verwenden

Fügen Sie das Token im Header ein Authorization mit dem Präfix Bearer:

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

Token erneuern

Token laufen nach 24 Stunden ab. Verwenden Sie den Refresh-Endpoint, um ein neues zu erhalten:

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

Die API hat Anfragelimits, um einen stabilen Service zu gewährleisten:

Rate-Limit-Header

Jede Antwort enthält informative Header:

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

Fehler 429: Zu viele Anfragen

Wenn Sie das Limit überschreiten, erhalten Sie einen 429-Fehler:

{
  "success": false,
  "error": "Sie haben das Anfragelimit überschritten. Versuchen Sie es in 45 Sekunden erneut.",
  "code": "RATE_LIMIT_EXCEEDED"
}

Authentifizierungsfehler