EVORA API : construire vos intégrations en 3 étapes

Sur le terrain événementiel en Afrique subsaharienne, un même constat revient dans chaque salle de production : le jour J, les données vivent dans quatre outils qui ne se parlent pas. La billetterie exporte un CSV, le CRM en importe un autre, le fichier de check-in circule sur WhatsApp, et l’équipe marketing reconstruit tout à la main le lundi. Ce chaînon manquant, c’est précisément ce qu’une event management API résout. L’API EVORA by Freeway Strategies expose l’ensemble du cycle événementiel — création d’événement, gestion des participants, check-in, campagnes — à vos développeurs. Ce guide vous montre comment brancher EVORA sur votre écosystème existant en trois étapes : authentification, appels aux endpoints, synchronisation par webhooks. Objectif : zéro ressaisie, données temps réel, intégrations pérennes.

Étape 1 — S’authentifier proprement sur l’API EVORA

Toute intégration sérieuse commence par une authentification robuste. EVORA repose sur OAuth2 avec le flow client_credentials pour les intégrations serveur-à-serveur — le cas d’usage dominant pour une agence qui synchronise ses systèmes internes. Selon la Eventbrite Event Industry Trends, plus de 60 % des organisateurs professionnels utilisent désormais au moins trois outils numériques par événement : sans authentification centralisée, chaque connexion devient une faille potentielle et une dette de maintenance.

Obtenir vos identifiants et votre token

Depuis votre console développeur EVORA, générez une paire client_id / client_secret. Ne les exposez jamais côté frontend. L’échange contre un token d’accès se fait ainsi :

curl -X POST https://api.evora.freewaystrategies.com/oauth/token 
  -H "Content-Type: application/json" 
  -d '{
    "grant_type": "client_credentials",
    "client_id": "VOTRE_CLIENT_ID",
    "client_secret": "VOTRE_CLIENT_SECRET",
    "scope": "events attendees checkins campaigns"
  }'

La réponse renvoie un access_token (valable 3600 secondes) et un refresh_token. Stockez le secret dans un gestionnaire de secrets (Vault, AWS Secrets Manager) et non dans le code source.

Sécuriser et rafraîchir le token

Chaque requête à l’API porte l’en-tête Authorization: Bearer {access_token}. Prévoyez une logique de rafraîchissement automatique : interceptez les réponses 401 Unauthorized, régénérez le token, rejouez la requête. Cette rigueur n’est pas cosmétique. Lors du déploiement d’une plateforme d’inscription pour un opérateur télécom régional gérant des tournées d’activation dans huit villes du Cameroun, l’absence de refresh automatique provoquait des coupures de synchronisation en pleine affluence. Une fois la logique implémentée, la disponibilité des données de check-in est passée à 99,9 %. Retenez : un token expiré en plein pic d’entrée à un gala de 2 000 personnes coûte plus cher que n’importe quel bug de code.

Étape 2 — Maîtriser les endpoints principaux

L’API EVORA est structurée en ressources REST. Quatre familles d’endpoints couvrent 90 % des besoins d’intégration événementielle. La logique est constante : GET pour lire, POST pour créer, PATCH pour mettre à jour, DELETE pour supprimer. Toutes les réponses sont en JSON paginé.

Les quatre ressources critiques

• /v1/events — création et gestion d’événements (dates, jauges, lieux, statut).
• /v1/events/{id}/attendees — inscription, mise à jour et segmentation des participants.
• /v1/events/{id}/checkins — enregistrement des entrées en temps réel (QR, badge, accréditation).
• /v1/campaigns — déclenchement de campagnes de communication liées à un événement (SMS, e-mail).

Exemple : récupérer la liste des participants confirmés d’un événement, avec pagination :

curl -X GET "https://api.evora.freewaystrategies.com/v1/events/evt_8842/attendees?status=confirmed&per_page=100&page=1" 
  -H "Authorization: Bearer {access_token}"

Créer un participant depuis votre CRM

Le flux le plus demandé : pousser un contact CRM directement dans EVORA sans double saisie.

curl -X POST "https://api.evora.freewaystrategies.com/v1/events/evt_8842/attendees" 
  -H "Authorization: Bearer {access_token}" 
  -H "Content-Type: application/json" 
  -d '{
    "first_name": "Aïcha",
    "last_name": "Ndongo",
    "email": "aicha.ndongo@example.cm",
    "phone": "+237690000000",
    "ticket_type": "vip",
    "metadata": { "source": "crm_salesforce", "segment": "grands_comptes" }
  }'

Le champ metadata est votre meilleur allié : il transporte n’importe quel attribut propre à votre organisation, ce qui facilite le rapprochement analytique en aval. Cette approche data-first n’est pas un luxe. Le HubSpot State of Marketing indique que les équipes exploitant des données unifiées entre canaux enregistrent des taux de conversion nettement supérieurs. Pour une banque régionale ayant intégré EVORA à son CRM lors d’un cycle de forums clients à Douala et Yaoundé, la réconciliation automatique inscription/check-in a réduit le temps de reporting post-événement de plusieurs jours à quelques heures.

Photo : Daniil Komov / Pexels

Étape 3 — Webhooks et rate limits : la synchronisation temps réel

Interroger l’API en boucle (polling) pour savoir « qui vient d’arriver » est une mauvaise pratique : coûteux, lent, et gourmand en quota. Les webhooks inversent la logique — EVORA vous notifie dès qu’un événement métier survient. C’est la clé de la donnée temps réel, un enjeu majeur quand on sait, d’après MPI FutureWatch, que la mesure d’impact en direct est devenue une exigence contractuelle chez la majorité des annonceurs premium.

Configurer et vérifier un webhook

Enregistrez une URL de réception qui écoutera les événements souhaités :

curl -X POST "https://api.evora.freewaystrategies.com/v1/webhooks" 
  -H "Authorization: Bearer {access_token}" 
  -H "Content-Type: application/json" 
  -d '{
    "url": "https://votre-app.cm/hooks/evora",
    "events": ["attendee.checked_in", "attendee.created", "event.updated"],
    "secret": "whsec_votre_secret_partage"
  }'

À chaque notification, EVORA signe le payload avec HMAC-SHA256 dans l’en-tête X-Evora-Signature. Vérifiez systématiquement cette signature avant de traiter la donnée — sinon n’importe qui pouvant deviner votre URL peut injecter de faux check-ins. Répondez 200 OK en moins de 5 secondes ; sinon EVORA rejoue la livraison avec un back-off exponentiel jusqu’à 24 heures.

Respecter les rate limits

L’API applique une limite de 600 requêtes par minute et par token en usage standard. Chaque réponse expose votre quota :

• X-RateLimit-Limit — plafond sur la fenêtre courante.
• X-RateLimit-Remaining — requêtes restantes.
• X-RateLimit-Reset — timestamp de réinitialisation.

En cas de dépassement, l’API renvoie 429 Too Many Requests avec un en-tête Retry-After. Implémentez une file d’attente avec back-off exponentiel et privilégiez les webhooks au polling pour préserver votre quota. Le Deloitte CMO Survey souligne que la performance technique des plateformes marketing pèse désormais directement sur le budget alloué aux outils. Autrement dit : une intégration qui sature son quota et rate des check-ins en direct devient un argument contre votre plateforme lors du prochain arbitrage budgétaire. Optimisez dès la conception.

Sources

• Eventbrite — Event Industry Trends & Academy
• MPI — FutureWatch Research
• HubSpot — State of Marketing Report
• Deloitte — CMO Survey