Espace développeurs

L'API Smart Event Network

Intégrez la Smart Event Card et le réseau Smart Event dans votre propre plateforme. API REST, authentifiée par clés sen_live_, hébergée à la racine de chaque déploiement.

Clés API par organisation

Générées depuis Smart Event Studio. Chaque appel est signé, audité, et limité à votre plateforme.

QR signés HMAC

Tokens à durée de vie courte (60s) signés côté serveur, vérifiables hors-ligne.

Webhooks (bientôt)

Recevez en temps réel les scans, achats et activations sur votre endpoint.

Authentification

Toutes les requêtes nécessitent un header Authorization avec votre clé sen_live_. Générez vos clés depuis Smart Event Studio → API.

curl https://api.smartevent.network/api/public/v1/events \
  -H "Authorization: Bearer sen_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET /api/public/v1/events

Liste les événements publiés de votre organisation.
{
  "data": [
    {
      "id": "…",
      "title": "Afro Night Lagos",
      "starts_at": "2026-08-12T20:00:00Z",
      "city": "Lagos",
      "ticket_categories": [{ "id": "…", "name": "VIP", "price": 25000 }]
    }
  ]
}

GET /api/public/v1/events/:id

Récupère le détail d'un événement (catégories de billets incluses).

POST /api/public/v1/scan

Active un billet pour un porteur de carte. Acceptez soit un card_number brut (saisie manuelle), soit un token SEN1 signé scanné depuis l'app du participant.
POST /api/public/v1/scan
{
  "event_id": "uuid-evt",
  "token": "SEN1.b64card.exp.sig"
}
POST /api/public/v1/scan
{
  "event_id": "uuid-evt",
  "card_number": "SEN 1234 5678 9012"
}

GET /api/public/v1/card/verify

Vérifie qu'un token SEN1 est authentique et non expiré (sans activer aucun billet). Idéal pour les portails et plateformes partenaires.
GET /api/public/v1/card/verify?token=SEN1.xxx.111.aaaa
→ { "valid": true, "card_number": "SEN ...", "status": "active" }

Codes de réponse

  • 200 — Succès
  • 400 — Requête invalide
  • 401 — Clé manquante, invalide ou révoquée
  • 404 — Ressource introuvable / hors organisation
  • 500 — Erreur serveur

Documentation interactive (Swagger)

Explorez et testez chaque endpoint dans votre navigateur, requêtes signées en direct avec votre clé.

Ouvrir Swagger UI openapi.json

SDKs officiels

Trois SDKs officiels avec la même surface d'API. Téléchargez directement ou importez depuis votre CDN favori.

JavaScript

Browsers, Node 18+, Deno, Bun, Workers

Télécharger →

React Native

Expo & RN CLI, fetch global

Télécharger →

Flutter / Dart

Mobile iOS + Android

Télécharger →

import { SmartEventClient } from "https://smarteventnetwork.com/sdk/smart-event-card.js";

const sen = new SmartEventClient({ apiKey: "sen_live_..." });
const events = await sen.events.list();
await sen.scan({ eventId, token: "SEN1.xxx.111.aaaa" });

Vous n'avez pas encore de clé ?

Créez une organisation depuis Smart Event Studio pour générer vos premières clés API.

Accéder à Smart Event Studio