API REST — /api/v1

Le moteur événementiel,
exposé par API.

L'API REST versionnée qui fait tourner nos propres applications est celle que vous intégrez : authentification OAuth2, websockets pour le temps réel, documentation OpenAPI générée depuis le code.

Lire la documentationParler à l'équipe
api.bifrost.events
curl https://api.bifrost.events/api/v1/events/42/attendees \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: fr"

Le socle

Ce que l'API expose

Les briques techniques de la plateforme, telles qu'elles existent dans le code.

/api/v1

API REST versionnée

Une API organisée par audiences — admin, organisateur, participant, hôtesse — sous un préfixe versionné unique.

OAuth2

Authentification

OAuth2 via Laravel Passport pour les intégrations, tokens Sanctum pour les applications mobiles.

OpenAPI

Documentation générée

Spécification Swagger/OpenAPI générée depuis le code, complétée d'un guide d'intégration Scribe.

ws

Temps réel

Canaux de broadcast websocket : présences, résultats d'activités, état du livestream.

QR

Badges QR chiffrés

Les badges embarquent un payload chiffré, vérifié au scan lors du check-in.

i18n

Trilingue fr / en / ar

La plateforme est trilingue de bout en bout, y compris les contenus générés par IA.

Temps réel

Des websockets pour ce qui bouge

Pendant un événement, l'état change en continu. Plutôt que d'interroger l'API en boucle, abonnez-vous aux canaux de broadcast et recevez les mises à jour au fil de l'eau.

  • Présences : arrivées et check-ins diffusés en direct
  • Activités : résultats des votes et quiz poussés aux clients abonnés
  • Livestream : état du direct synchronisé sur toutes les interfaces
# REST — audiences
GET /api/v1/admin/…
GET /api/v1/events/…
GET /api/v1/attendee/…
GET /api/v1/hostess/…
# Websockets — broadcast channels
presence event.{id}.attendance
channel  event.{id}.activity.results
channel  event.{id}.livestream.status

Intégration

De la documentation à la production

Ce qu'il faut pour brancher vos systèmes sur la plateforme.

Documentation

Explorez les endpoints dans Swagger et suivez le guide Scribe pour vos premiers appels.

docs.bifrost.events

Point d'entrée unique

Une base d'API versionnée : vos intégrations ne cassent pas quand l'API évolue.

api.bifrost.events/api/v1

Environnement dédié

Chaque organisation peut disposer d'une instance dédiée : un environnement isolé pour intégrer, tester, puis passer en production.

Prêt à intégrer ?

Parlez-nous de votre cas d'usage et des systèmes que vous voulez connecter.

Parler à l'équipeExplorer la documentation