API · protocole ouvert · v1

Un protocole ouvert
pour scanner les
billets Praticable.

Intégrez le contrôle d'accès dans votre propre infrastructure avec une API REST simple, documentée et gratuite pour tous les organisateurs Praticable.

POST · /api/v1/tickets/check-in 200 OK · 84 ms
curl -X POST "https://tickets.example.com/api/v1/tickets/check-in" \
  -H "Authorization: Bearer sk_live_01H..." \
  -d '{
    "tid": "01HXXX...ULID",
    "eid": "evt_01HXXX",
    "scanned_at": "2026-06-15T19:42:13Z",
    "scanner_id": "device-uuid",
    "gate_id": "north",
    "idempotency_key": "uuid-v4"
  }'

// → { "status": "valid", "ticket": { "holder_name": "Léa M.", ... } }

01 Pourquoi ce protocole existe Court honnête

Pour les équipes
qui ont déjà
leur propre matériel.

Praticable Scan couvre 90 % des cas. Mais certains lieux ont déjà des tourniquets, des lecteurs NFC, des kiosques ou un système de contrôle d'accès intégré. Pour eux, nous publions un protocole ouvert : une API REST, documentée, versionnée, gratuite.

Pas de SDK obligatoire, pas de widget imposé. Vous envoyez une requête HTTP, vous recevez une réponse JSON. C'est tout.


Stable

v1 figée, déprécation annoncée 12 mois à l'avance.

Documenté

OpenAPI 3.1, SDKs générés, exemples par langage.

Gratuit

Aucun coût pour les organisateurs Praticable.


02 Ce que vous pouvez construire Six cas d'usage typiques

Vos intégrations, votre infrastructure, votre matériel.

01

Scanners hardware

Connectez vos douchettes, pistolets ou terminaux de scan existants via l'API REST.

02

Kiosques en libre service

Validez les billets depuis des bornes interactives en entrée de salle.

03

Contrôle d'accès

Tourniquets, badges, intégrations Inepro/Sirius et systèmes physiques.

04

Lecteurs NFC personnalisés

Abonnements, RFID, cartes de membre et contrôle sans contact.

05

Webhooks d'événement

Recevez les notifications de scan, de vente et de remboursement en temps réel.

06

Intégrations POS

Bar, restauration liés aux droits d'accès et à la billetterie.


03 Le flux complet Discovery → enrollment → check-in

Du QR de setup au check-in, trois étapes.

01 · Découverte de l'issuer GET · /.well-known/ticket-issuer.json
curl "https://tickets.example.com/.well-known/ticket-issuer.json"

// → {
  "protocol_version": 1,
  "issuer": "https://tickets.example.com",
  "name": "Festival des Arts",
  "keys": [{
    "kid": "a1b2c3d4",
    "alg": "Ed25519",
    "public_key": "base64url..."
  }]
}
02 · Enrollment du scanner POST · /api/v1/scanners/enroll
curl -X POST "https://tickets.example.com/api/v1/scanners/enroll" \
  -d '{
    "token": "st_01HXXX...enrollment-token",
    "scanner_id": "device-uuid",
    "scanner_name": "iPhone 14 - Entrée Nord"
  }'

// → { "api_key": "sk_live_01H...", "scope": { "eid": "evt_..." } }
03 · Check-in d'un billet POST · /api/v1/tickets/check-in
curl -X POST "https://tickets.example.com/api/v1/tickets/check-in" \
  -H "Authorization: Bearer sk_live_01H..." \
  -d '{
    "tid": "01HXXX...ULID",
    "eid": "evt_01HXXX",
    "scanned_at": "2026-06-15T19:42:13Z",
    "scanner_id": "device-uuid",
    "gate_id": "north",
    "idempotency_key": "uuid-v4"
  }'

// → {
  "status": "valid",
  "ticket": {
    "tid": "01HXXX...ULID",
    "holder_name": "Léa Marchand",
    "ticket_type": "VIP",
    "checked_in_at": "2026-06-15T19:42:13Z"
  }
}

04 Ressources Tout est public, tout est versionné

Documentation API

praticable.eu/docs/api

Référence complète, guides, exemples par langage et tutoriels pas à pas.

Ouvrir →

Spec OpenAPI

praticable.eu/openapi.yaml

Spécification OpenAPI 3.1, import directement dans Postman ou votre générateur de SDK.

Ouvrir →

SDKs officiels

github.com/praticable

Bibliothèques générées en Python, Node, Go et PHP. MIT license.

Ouvrir →

Changelog · status

status.praticable.eu

Historique des versions, état en temps réel de l'API et incidents passés.

Ouvrir →

05 Partenariats techniques Contact direct

Une question, un cas d'usage particulier, un partenariat ?

Pour tout ce qui concerne l'intégration, la documentation suffit dans la majorité des cas. Si vous travaillez sur un partenariat technique ou un cas d'usage hors du commun, écrivez-nous directement.

developers@praticable.eu Écrire à l'équipe →

06 Commencer

Trois étapes suffisent.
Commencez maintenant.

Le protocole est ouvert, la documentation est publique, les SDKs sont gratuits. Lancez votre première intégration en quelques minutes.