API mobile

La plateforme propose une API REST pour le développement d’applications mobiles ou les intégrations tierces.

---

Authentification (token Bearer)

L’API utilise une authentification par token (tokens Bearer) via Laravel Sanctum.

Pour obtenir un token :

Envoyez une requête POST à /api/v1/auth/login avec votre email et mot de passe :

{
  "email": "vous@exemple.com",
  "password": "votre-mot-de-passe"
}

La réponse inclut un access_token. Incluez ce token dans toutes les requêtes suivantes :

Authorization: Bearer {access_token}

Les tokens expirent après 30 jours. Utilisez /api/v1/auth/logout pour révoquer un token.

---

Endpoints disponibles

Méthode	Endpoint	Auth requise	Description
POST	/api/v1/auth/login	Non	Obtenir un token Bearer
POST	/api/v1/auth/register	Non	Créer un nouveau compte utilisateur
POST	/api/v1/auth/logout	Oui	Révoquer le token actuel
POST	/api/v1/auth/logout-all	Oui	Révoquer tous les tokens
GET	/api/v1/events	Non	Lister les événements publiés
GET	/api/v1/events/{slug}	Non	Voir un seul événement
GET	/api/v1/events/{slug}/agenda	Non	Voir les sessions de l’événement
GET	/api/v1/events/{slug}/floor-plans	Non	Lister les plans de salle publiés
GET	/api/v1/events/{slug}/floor-plans/{id}	Non	Plan détaillé + marqueurs
GET	/api/v1/profile	Oui	Voir/mettre à jour le profil utilisateur
GET	/api/v1/registrations	Oui	Lister les inscriptions de l’utilisateur
GET	/api/v1/attendees	Oui	Parcourir l’annuaire des participants
POST	/api/v1/sessions/{id}/register	Oui	S’inscrire à une session
POST	/api/v1/sessions/{id}/bookmark	Oui	Mettre une session en favori
GET	/api/v1/organizations	Oui	Lister les organisations de l’utilisateur

La documentation complète de l’API (avec les schémas de requête/réponse) est générée automatiquement par Scramble et disponible à /api/docs.

---

Limites de débit

Type d’utilisateur	Limite
Authentifié	60 requêtes par minute
Non authentifié	30 requêtes par minute

Lorsque la limite est dépassée, l’API renvoie une réponse 429 Too Many Requests.