DéveloppeursVersion tablette · pilote
Développer avec l’API Kelna
Comprenez les contrats HTTP utilisés par l’application et les limites du socle actuel.
Périmètre actuel
Cette référence décrit l’API interne de l’application tablette, passe et console. Elle ne constitue pas encore une offre d’intégration partenaire stable. Il n’existe ni clé API partenaire, ni OAuth partenaire, ni webhook public.
Les routes de salle utilisent un appareil jumelé. Les routes d’organisation utilisent une session humaine avec MFA et des permissions par établissement. La documentation est statique : elle ne reçoit aucun cookie de l’application et ne fournit pas de console d’exécution connectée.
Origine et transport
L’origine de l’application d’essai est https://app.kelna.fr ; les chemins commencent par /api. En local, utilisez l’origine du front et son proxy API. Les exemples fetch supposent une exécution dans un client autorisé sur cette même origine, pas depuis docs.kelna.fr.
Les écritures exigent l’en-tête Origin correspondant exactement à l’origine configurée, ainsi que l’identité attendue. Les requêtes JSON ont une taille maximale de 64 Kio. Aucun accès CORS public n’est fourni. Les réponses API portent Cache-Control: no-store.
curl https://app.kelna.fr/api/health
# {"status":"ok"}Organisations et permissions
L’organisation contient les établissements. Un chemin d’organisation ne donne aucun droit à lui seul : le serveur valide l’appartenance, les permissions et l’isolation PostgreSQL. Une identité d’appareil est liée à un seul établissement.
Les contrôles reposent sur des codes tels que venue.view, devices.manage, tables.update et tables.join, jamais sur un nom de rôle. Les attributions de rôle empêchent l’escalade et la suppression du dernier Propriétaire.
Données traitées
Les événements concernent des tables, leurs états et leurs horodatages. Aucun nom ou identifiant de personnel ne doit être ajouté aux commandes. Aucun endpoint documenté n’accepte d’image ou de vidéo.
La configuration caméra reste expérimentale. Elle ne raccorde pas les observations de présence au service actuel.
Besoin d’un coup de main ?
Indiquez l’étape qui bloque et le message affiché. Gardez vos mots de passe et codes de connexion privés.
Contacter l’équipe Kelna