API · offenes Protokoll · v1

Ein offenes Protokoll
zum Scannen von
Praticable-Tickets.

Integrieren Sie die Zutrittskontrolle in Ihre eigene Infrastruktur mit einer einfachen, dokumentierten und kostenlosen REST API für alle Praticable-Veranstalter.

Vollständige Dokumentation → Kontakt
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-fähig OpenAPI 3.1 · protocol v1
01 Warum dieses Protokoll existiert Kurz und ehrlich

Für Teams,
die bereits über
eigene Hardware verfügen.

Praticable Scan deckt 90 % der Fälle ab. Aber einige Veranstaltungsorte haben bereits Drehkreuze, NFC-Lesegeräte, Kioske oder ein integriertes Zutrittskontrollsystem. Für sie veröffentlichen wir ein offenes Protokoll: eine REST API, dokumentiert, versioniert, kostenlos.

Kein verpflichtendes SDK, kein aufgezwungenes Widget. Sie senden eine HTTP-Anfrage, Sie erhalten eine JSON-Antwort. Das ist alles.

Stabil

v1 eingefroren, Abkündigung wird 12 Monate im Voraus angekündigt.

Dokumentiert

OpenAPI 3.1, Beispiele nach Programmiersprache.

Kostenlos

Keine Kosten für Praticable-Veranstalter.

02 Was Sie bauen können Sechs typische Anwendungsfälle

Ihre Integrationen, Ihre Infrastruktur, Ihre Hardware.

01

Hardware-Scanner

Verbinden Sie Ihre vorhandenen Barcode-Lesegeräte, Scanner oder Terminals über die REST API.

02

Self-Service-Kioske

Validieren Sie Tickets an interaktiven Terminals am Eingang des Veranstaltungsortes.

03

Zutrittskontrolle

Drehkreuze, Badges, Inepro/Sirius-Integrationen und physische Systeme.

04

NFC-Lesegeräte

Abonnements, RFID, Mitgliedskarten und kontaktlose Zutrittskontrolle.

05

Event-Webhooks

Erhalten Sie Scan-, Verkaufs- und Erstattungsbenachrichtigungen in Echtzeit.

06

POS-Integrationen

Bar, Catering verknüpft mit Zutrittsrechten und Ticketing.

03 Der vollständige Ablauf Discovery → Enrollment → Check-in

Vom Setup-QR bis zum Check-in, drei Schritte.

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-Signaturen Offline-fähig · Doppelscan-Prävention
04 Ressourcen Alles ist öffentlich, alles ist versioniert

API-Dokumentation

praticable.eu/docs/api

Vollständige Referenz, Anleitungen, Beispiele nach Programmiersprache und Schritt-für-Schritt-Tutorials.

Öffnen →

OpenAPI-Spezifikation

praticable.eu/openapi.yaml

OpenAPI 3.1-Spezifikation, direkt in Postman oder Ihren SDK-Generator importierbar.

Öffnen →

Changelog · Status

praticable.eu/de/status

Versionshistorie, API-Status in Echtzeit und vergangene Vorfälle.

Öffnen →
05 Technische Partnerschaften Direkter Kontakt

Eine Frage, ein spezieller Anwendungsfall, eine Partnerschaft?

Für alles rund um Integration deckt die Dokumentation die meisten Fälle ab. Wenn Sie an einer technischen Partnerschaft oder einem ungewöhnlichen Anwendungsfall arbeiten, schreiben Sie uns direkt.

developers@praticable.eu Dem Team schreiben →
06 Erste Schritte

Drei Schritte genügen.
Jetzt starten.

Das Protokoll ist offen und die Dokumentation ist öffentlich. Starten Sie Ihre erste Integration in Minuten.

Vollständige Dokumentation → Kontakt
Sprache
FR · EN · NL · ES · DE