Skip to main content
POST
Validar el acceso de una pulsera a una zona

Autorizaciones

Authorization
string
header
requerido

API key del integrador, emitida desde el panel de VENTRY. Formato vk_live_... en producción y vk_test_... en entornos de prueba.

Cuerpo

application/json
wristband_code
string
requerido

Identificador NFC leído de la pulsera.

zone
string
requerido

Id de zona de GET /zones.

direction
enum<string>

Si el control cuenta aforo: entry suma a la zona y exit resta. Sin él, solo se comprueba el acceso y el aforo no cambia.

Opciones disponibles:
entry,
exit

Respuesta

Resultado de la comprobación de acceso.

Resultado de la comprobación de acceso.

object
enum<string>
Opciones disponibles:
access_check
allowed
boolean
reason
string
attendee_name
null | string
ticket_type
null | string
wristband_status
null | string
direction
null | enum<string>

El sentido pedido, o null si solo se comprobó el acceso.

Opciones disponibles:
entry,
exit,
null
counted
boolean

Si cambió el aforo. Una reentrada sin haber salido, o una salida de quien no constaba dentro, se registran pero no cuentan.

occupancy
null | object

Ocupación de la zona tras el paso. max 0 significa sin límite.