Inicio rapido

La API externa de ZPP permite a plataformas de terceros consultar tramos (zonas de parqueo), registrar clientes y vehiculos, crear y pagar reservas, y consultar o pagar sanciones.

Servidores

Ambiente	URL base
Desarrollo	`https://api-dev.zonaparqueo.com`
Produccion	`https://api.zonaparqueo.com`

Todos los endpoints cuelgan del prefijo /external.

Los tres pasos

Autenticarse. POST /external/login devuelve un token de sesion; con el se genera un token API permanente. Ver Autenticacion.
Enviar el token en cada peticion, en el header Authorization: Token {token_id}:{token_secret}.
Llamar al endpoint que necesites. La referencia documenta cada uno.

Primera peticion

curl -X GET "https://api-dev.zonaparqueo.com/external/tramos" \
  -H "Authorization: Token TU_TOKEN_ID:TU_TOKEN_SECRET"

La respuesta trae el catalogo completo de tramos (alrededor de 414, de los cuales unos 359 estan activos), con coordenadas, horario de operacion y contadores de cupo.

Forma de las respuestas

Todas las respuestas siguen la misma envoltura:

{ "estado": "ok", "data": { } }

Ante un error, estado vale fail y aparece un campo error con el mensaje:

{ "estado": "fail", "error": "La placa no existe" }

Alta de un vehiculo

Registrar un vehiculo son dos llamadas, en este orden:

POST /external/placa — registra la placa en el sistema.
POST /external/vehiculo — crea el vehiculo vinculando esa placa a un cliente.

Saltarse el primer paso hace que el segundo falle.