API · protocolo abierto · v1

Un protocolo abierto
para escanear
entradas de Praticable.

Integre el control de acceso en su propia infraestructura con una API REST sencilla, documentada y gratuita para todos los organizadores de 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 Por qué existe este protocolo Breve y honesto

Para equipos
que ya tienen
su propio hardware.

Praticable Scan cubre el 90 % de los casos. Pero algunas salas ya tienen torniquetes, lectores NFC, quioscos o un sistema de control de acceso integrado. Para ellos, publicamos un protocolo abierto: una API REST, documentada, versionada, gratuita.

Sin SDK obligatorio, sin widget impuesto. Usted envía una solicitud HTTP, recibe una respuesta JSON. Eso es todo.


Estable

v1 congelada, obsolescencia anunciada con 12 meses de antelación.

Documentada

OpenAPI 3.1, ejemplos por lenguaje.

Gratuita

Sin coste para los organizadores de Praticable.


02 Qué puede construir Seis casos de uso típicos

Sus integraciones, su infraestructura, su hardware.

01

Escáneres de hardware

Conecte sus lectores de código de barras, escáneres o terminales existentes a través de la API REST.

02

Quioscos de autoservicio

Valide entradas desde terminales interactivos en la entrada de la sala.

03

Control de acceso

Torniquetes, credenciales, integraciones Inepro/Sirius y sistemas físicos.

04

Lectores NFC personalizados

Abonos, RFID, tarjetas de membresía y control de acceso sin contacto.

05

Webhooks de eventos

Reciba notificaciones de escaneo, venta y reembolso en tiempo real.

06

Integraciones con punto de venta

Barra, restauración vinculada a los derechos de acceso y la venta de entradas.


03 El flujo completo Discovery → enrollment → check-in

Del código QR de configuración al check-in, tres pasos.

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 Recursos Todo es público, todo está versionado

Documentación de la API

praticable.eu/docs/api

Referencia completa, guías, ejemplos por lenguaje y tutoriales paso a paso.

Abrir →

Especificación OpenAPI

praticable.eu/openapi.yaml

Especificación OpenAPI 3.1, importe directamente en Postman o en su generador de SDK.

Abrir →

Changelog · estado

praticable.eu/es/estado

Historial de versiones, estado de la API en tiempo real e incidentes pasados.

Abrir →

05 Colaboraciones técnicas Contacto directo

Una pregunta, un caso de uso específico, una colaboración?

Para todo lo relacionado con la integración, la documentación cubre la mayoría de los casos. Si está trabajando en una colaboración técnica o un caso de uso inusual, escríbanos directamente.

developers@praticable.eu Escribir al equipo →

06 Empezar

Solo se necesitan tres pasos.
Empiece ahora.

El protocolo es abierto y la documentación es pública. Lance su primera integración en minutos.