Demarrage rapide

Creer un compte

Inscrivez-vous sur SalonHub pour obtenir un compte. Vous beneficiez automatiquement de 14 jours d'essai gratuit avec acces complet a l'API.

curl -X POST https://api.salonhub.app/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "salon_name": "Mon Salon",
    "salon_email": "contact@monsalon.fr",
    "first_name": "Marie",
    "last_name": "Dupont",
    "email": "marie@monsalon.fr",
    "password": "motdepasse123"
  }'

Obtenir une cle API

Les cles API sont disponibles pendant la periode d'essai (14 jours), puis necessitent un plan Developer (14,99/mois) ou Custom.

# Utilisez votre token JWT pour creer une cle API
curl -X POST https://api.salonhub.app/api/api-keys \
  -H "Authorization: Bearer VOTRE_TOKEN_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mon integration",
    "scopes": ["clients:read", "appointments:read", "appointments:write"]
  }'

Premier appel API

Utilisez votre cle API pour interroger l'API SalonHub.

curl https://api.salonhub.app/api/clients \
  -H "Authorization: Bearer sk_live_votre_cle_api"

{
  "success": true,
  "data": [
    {
      "id": 1,
      "first_name": "Sophie",
      "last_name": "Martin",
      "email": "sophie@email.com",
      "phone": "+33612345678"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Authentification

SalonHub supporte deux methodes d'authentification :

• JWT Token — Pour les apps et dashboards. Obtenu via POST /auth/login, expire apres 7 jours.
• Cle API (sk_live_) — Pour les integrations. Permanente (jusqu'a revocation). Necessite le plan Developer ou Custom.

Concepts cles

• Multi-tenant : Chaque salon a ses propres donnees isolees. Votre cle API accede uniquement aux donnees de votre salon.
• Pagination : Utilisez ?limit=50&offset=0 pour paginer les resultats.
• Erreurs : Toutes les erreurs retournent { "success": false, "error": "...", "message": "..." }
• Rate limit : 5 000 requetes/jour par cle API. Header X-RateLimit-Remaining indique les requetes restantes.
• Scopes : Limitez l'acces de chaque cle avec des scopes : clients:read, appointments:write, etc.