ParkingGest · API de integración (barreras y cajeros)
ParkingGest incluye una API para que los sistemas de barreras y cajeros automáticos con lectura de matrícula (LPR) operen el parking por su cuenta: registrar la entrada, consultar el importe pendiente y confirmar el pago para abrir la barrera de salida. Toda la comunicación se autentica con un token.
Activar la API y obtener el token
- Ve a Menú Parking → Configuración de ParkingGest.
- Marca la casilla Permitir la API de integración (barreras y cajeros) y pulsa Guardar.
- En el bloque API de integración (barreras y cajeros) verás el Token de la API. Ese token debe configurarse en tus barreras y cajeros para que puedan comunicarse.
- Justo debajo, en Endpoints de ejemplo, tienes las URL listas para copiar, ya con la dirección de tu instalación y el token.
Regenerar el token
- En el mismo bloque, pulsa Regenerar y confirma.
- Se genera un token nuevo. Importante: los sistemas configurados con el token anterior dejarán de funcionar hasta que los actualices con el nuevo.
Endpoints disponibles
Todas las llamadas se hacen a la ruta ParkingGestApi e incluyen el parámetro token. Las respuestas se devuelven en formato JSON.
- Registrar entrada
.../ParkingGestApi?action=entrada&token=TU_TOKEN&matricula=1234ABC
Registra la entrada del vehículo y devuelve el ticket. Si la matrícula es de un abonado vigente, la sesión se marca como de abonado. La respuesta incluye abrir: true para subir la barrera. Opcionalmente puedes indicar &canal=barrera para identificar el origen.
- Consultar importe
.../ParkingGestApi?action=consulta&token=TU_TOKEN&ticket=PK-XXXX
Devuelve el importe pendiente de la sesión abierta, junto con la matrícula, la hora de entrada y los minutos. También puedes localizar la sesión por matrícula con &matricula=1234ABC.
- Confirmar pago
.../ParkingGestApi?action=pago&token=TU_TOKEN&ticket=PK-XXXX&metodo=tarjeta
Cierra la sesión como cobrada y devuelve abrir: true para levantar la barrera de salida. Puedes indicar el método de pago con &metodo= (por defecto, tarjeta) y localizar la sesión por matrícula en lugar de por ticket.
Notas de seguridad
- Si la API está desactivada, todas las llamadas responden con un error y no se procesa ninguna operación.
- Si el token no coincide con el configurado, la llamada se rechaza. Trata el token como una credencial: no lo compartas fuera de tus sistemas de barreras y cajeros.
Con la API configurada, las entradas y salidas registradas por las barreras aparecen como sesiones (canal barrera) en «Sesiones de estacionamiento» y se reflejan en el «Panel de control».