Saltar al contenido principal

Introducción a la API de Parkup

Bienvenido a la documentación de la API pública de Parkup. Esta guía te ayudará a integrar tu aplicación con nuestro sistema de gestión de estacionamientos.

¿Qué es Parkup?​

Parkup es una plataforma innovadora que ofrece APIs públicas diseñadas para facilitar la integración con sistemas centrales de gestión de estacionamientos y movilidad. Nuestra solución permite a desarrolladores y empresas conectar sus aplicaciones con funcionalidades clave de manera simple y eficiente.

Características Principales​

  • Gestión de Usuarios: Crea, actualiza y gestiona perfiles de usuarios para optimizar la experiencia de tus clientes.
  • Integración RFID: Asocia stickers y etiquetas de identificación por radiofrecuencia para acceso automatizado.
  • Reservas Inteligentes: Crea, modifica y gestiona reservas de espacios en tiempo real.
  • Integración Simplificada: APIs RESTful bien documentadas para una integración rápida y sencilla.
  • Seguridad Avanzada: Autenticación OAuth2 y encriptación de extremo a extremo.

Comenzando​

Para comenzar a usar la API de Parkup, necesitarás:

  1. Obtener Credenciales de API

    • Contacta con nuestro equipo de soporte para obtener tus credenciales
    • Recibirás un Client ID y Client Secret
  2. Configurar Autenticación

    • Implementa el flujo OAuth2
    • Gestiona tokens de acceso y refresh tokens
  3. Realizar tu Primera Llamada

    • Usa el token de acceso en el header de autorización
    • Comienza con endpoints básicos como la validación de token

Estructura de la API​

La API está organizada en cuatro secciones principales:

  1. Autenticación

    • Gestión de tokens
    • Validación de sesiones
  2. Estacionamientos

    • Listado de estacionamientos
    • Detalles y planes disponibles
  3. Reservas

    • Creación de reservas
    • Cancelación y consulta
  4. Usuarios

    • Gestión de clientes
    • Administración de etiquetas RFID

URL Base​

Todas las llamadas a la API deben realizarse a la siguiente URL base:

https://api.parkup.cl

Límites de Uso​

La API implementa límites de uso para garantizar un servicio justo y estable. Los límites específicos se detallan en la documentación de cada endpoint.

Manejo de Errores​

La API utiliza códigos de estado HTTP estándar para indicar el éxito o fracaso de las solicitudes. Las respuestas de error incluyen un mensaje explicativo sobre lo que salió mal.

Soporte​

Si necesitas ayuda o tienes preguntas sobre la API, por favor contacta a nuestro equipo de soporte:

Próximos Pasos​

  1. Revisa la sección de Autenticación para configurar tu acceso
  2. Explora los Estacionamientos disponibles
  3. Aprende a gestionar Reservas
  4. Configura la Gestión de Usuarios