API · open protocol · v1

Een open protocol
om Praticable-
tickets te scannen.

Integreer toegangscontrole in uw eigen infrastructuur met een eenvoudige, gedocumenteerde en gratis REST API voor alle Praticable-organisatoren.

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 Waarom dit protocol bestaat Kort en eerlijk

Voor teams
die al hun
eigen hardware hebben.

Praticable Scan dekt 90 % van de gevallen. Maar sommige locaties hebben al tourniquets, NFC-lezers, kiosken of een geintegreerd toegangscontrolesysteem. Voor hen publiceren wij een open protocol: een REST API, gedocumenteerd, geversioneerd, gratis.

Geen verplichte SDK, geen opgelegd widget. U stuurt een HTTP-verzoek, u ontvangt een JSON-antwoord. Dat is alles.


Stabiel

v1 vastgelegd, afschaffing wordt 12 maanden vooraf aangekondigd.

Gedocumenteerd

OpenAPI 3.1, voorbeelden per programmeertaal.

Gratis

Geen kosten voor Praticable-organisatoren.


02 Wat u kunt bouwen Zes typische toepassingen

Uw integraties, uw infrastructuur, uw hardware.

01

Hardware scanners

Verbind uw bestaande handlezers, scanpistolen of scanterminals via de REST API.

02

Zelfbedieningskiosken

Valideer tickets vanaf interactieve zuilen bij de ingang van de zaal.

03

Toegangscontrole

Tourniquets, badges, Inepro/Sirius-integraties en fysieke systemen.

04

Aangepaste NFC-lezers

Abonnementen, RFID, ledenkaarten en contactloze controle.

05

Event webhooks

Ontvang meldingen van scans, verkopen en terugbetalingen in real time.

06

POS-integraties

Bar, catering gekoppeld aan toegangsrechten en ticketing.


03 De volledige flow Discovery → enrollment → check-in

Van de setup-QR tot check-in, drie stappen.

01 · Issuer discovery 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 · Scanner enrollment 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 · Ticket check-in 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 Bronnen Alles is publiek, alles is geversioneerd

API-documentatie

praticable.eu/docs/api

Volledige referentie, handleidingen, voorbeelden per programmeertaal en stapsgewijze tutorials.

Openen →

OpenAPI-spec

praticable.eu/openapi.yaml

OpenAPI 3.1 specificatie, direct te importeren in Postman of uw SDK-generator.

Openen →

Changelog · status

praticable.eu/nl/status

Versiegeschiedenis, real-time status van de API en eerdere incidenten.

Openen →

05 Technische partnerschappen Rechtstreeks contact

Een vraag, een specifieke toepassing, een partnerschap?

Voor alles wat integratie betreft, volstaat de documentatie in de meeste gevallen. Als u werkt aan een technisch partnerschap of een uitzonderlijke toepassing, schrijf ons dan rechtstreeks.

developers@praticable.eu Schrijf het team →

06 Aan de slag

Drie stappen volstaan.
Begin nu.

Het protocol is open en de documentatie is publiek. Start uw eerste integratie in enkele minuten.