URL de base
APP_BASE_URL suivie de /api/v1.
Faire votre première requête
1
Créer une clé API
Dans le tableau de bord, allez dans Réglages > Clés API et cliquez sur Créer une clé API. Choisissez l’accès dont la clé a besoin. Consultez Authentification.
2
Appeler l'API
data :
Conventions
- Les requêtes et les réponses utilisent JSON. Les noms de champs sont en
snake_case. - Les identifiants sont des UUID et ne changent jamais.
- Les horodatages suivent la norme ISO 8601 en UTC, par exemple
2026-09-29T13:30:00.000Z. Le corps des requêtes accepte aussi un décalage numérique comme-04:00. - Les listes renvoient
data,next_cursorethas_more. Consultez Requêtes et erreurs. - Chaque clé appartient à une seule entreprise. Vous ne transmettez jamais d’identifiant d’entreprise.
OpenAPI
L’API publie un document OpenAPI 3.1 àGET /api/v1/openapi.json, sans clé requise. LobbyStack le génère à partir des mêmes schémas que ceux qu’utilise le serveur pour valider les requêtes. Il correspond donc toujours à la version en service. Importez-le dans Postman, générez un client ou parcourez la section Référence de l’API de cette documentation, que LobbyStack construit à partir du même fichier.
Gestion des versions
La version fait partie du chemin :/api/v1. Dans la v1, LobbyStack n’apporte que des ajouts :
- De nouveaux points de terminaison, de nouveaux champs de requête facultatifs et de nouveaux champs de réponse.
- De nouvelles valeurs dans des listes comme les types d’événements webhook et les codes d’erreur.
/api/v2. Supprimer ou renommer un champ, changer un type ou ajouter un champ de requête obligatoire constitue un changement incompatible. Quand une nouvelle version sort, la v1 continue de fonctionner en parallèle. Les charges utiles des webhooks contiennent api_version pour que vous sachiez quelle forme vous avez reçue.