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.

Volledige documentatie → Contact opnemen
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.", ... } }
Ed25519 · idempotent · offline-capable OpenAPI 3.1 · protocol v1

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.

Uw integraties, uw infrastructuur, uw hardware.

Hardware scanners

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

Zelfbedieningskiosken

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

Toegangscontrole

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

Aangepaste NFC-lezers

Abonnementen, RFID, ledenkaarten en contactloze controle.

Event webhooks

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

POS-integraties

Bar, catering gekoppeld aan toegangsrechten en ticketing.

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"
  }
}
Idempotent · Ed25519 signatures Offline-capable · double-scan prevention

API-documentatie

praticable.eu/docs/api

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

Openen →

OpenAPI-spec

praticable.eu/nl/docs/openapi

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

Openen →

Status

praticable.eu/nl/status

Realtime status van klantinstanties en de API, met uptime-geschiedenis van de laatste 90 dagen.

Openen →

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 →

Drie stappen volstaan.
Begin nu.

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

Volledige documentatie → Contact opnemen