API RESTful Cityflow

Calcula la tarifa de un trayecto según tipo de vehículo y duración en minutos.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/calculate_trip_fare' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"vehicle_type": "<valor>", "duration_minutes": 0}'

Devuelve las zonas operativas y reglas de geofencing de una ciudad.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/get_operating_zones' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"city_id": "<valor>"}'

Estado en tiempo real de la flota: disponibilidad, batería y ubicación GPS.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/get_vehicles_status' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"city_id": "<valor>"}'

Crea una reserva de vehículo dentro de un campus corporativo.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/create_campus_reservation' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"employee_id": "<valor>", "campus_id": "<valor>"}'

Registra un usuario corporativo validando que el email pertenezca al dominio de la empresa (@empresa.com).

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/register_corporate_user' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"email": "<valor>", "company_id": "<valor>"}'

Asigna permisos de uso de flota por departamento o perfil del empleado.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/set_employee_permissions' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"employee_id": "<valor>"}'

Cancela una reserva anticipada.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/cancel_booking' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"booking_id": "<valor>"}'

Crea una reserva anticipada de alquiler (corta o larga duración).

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/create_advance_booking' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"customer_email": "<valor>", "property_id": "<valor>", "start_date": "<valor>"}'

Consulta el detalle de una reserva existente.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/get_booking' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"booking_id": "<valor>"}'

Vende un pase turístico por día o por semana.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/purchase_tourist_pass' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"pass_type": "<valor>", "customer_email": "<valor>"}'

Check-in de un alquiler: entrega del vehículo y código de desbloqueo.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/rental_checkin' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"booking_id": "<valor>"}'

Check-out de un alquiler: devolución del vehículo y liquidación.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/rental_checkout' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"booking_id": "<valor>"}'

Valida un pase turístico y devuelve su vigencia restante.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/validate_tourist_pass' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"pass_code": "<valor>"}'

Métricas segregadas por franquicia o propiedad, con filtros de periodo y tipo de métrica.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/get_franchise_metrics' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"franchise_id": "<valor>"}'

Panel Master: supervisión centralizada de todas las flotas, ciudades y franquicias.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/get_master_overview' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"period": "<valor>"}'

Alta de una bicicleta en el sistema (equivalente a la gestión interna de la página de administración).

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/create_bike' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"bike_name": "<valor>"}'

Alta de un hotel/propiedad en la plataforma.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/create_hotel' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"hotel_name": "<valor>", "city": "<valor>"}'

Define los precios de alquiler específicos de un hotel.

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/set_hotel_prices' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"hotel_id": "<valor>"}'

Cambia el estado operativo de una bicicleta (available, rented, maintenance).

Parámetros (body JSON)

curl -X POST \
  'https://pruebas.cityflow.app/api/v1/update_bike_status' \
  -H 'Authorization: Bearer [API_KEY]' \
  -H 'Content-Type: application/json' \
  -d '{"bike_id": "<valor>", "status": "<valor>"}'

Llamadas auxiliares al propio backend de la plataforma (cálculos de business case, p. ej. número de alquileres).

Proveedor de email transaccional. Envía los correos operativos de la plataforma: confirmaciones, alertas internas y correos de la app (con o sin copia).

Integración con Buildprint para lanzar agentes automatizados (p. ej. el agente de novedades).

Utilidades internas de clonado/migración de datos entre entornos (obtener un hotel y crear registros).

IA generativa de Google. Se usa para generar automáticamente causas probables de averías a partir de la descripción de la incidencia.

Plataforma externa de rastreo GPS: autenticación, listado de dispositivos y lectura de datos de posición de cada rastreador.

ERP de facturación. Gestiona contactos, facturas, recibos de venta, cobros y envío de documentos.

Segunda versión de la integración con Holded, dedicada a facturas recurrentes.

Candados de llave inteligente KeySafe: reclamar la propiedad de un candado y gestionar los slots de llaves electrónicas (eKeys).

Candados inteligentes LINKA: consulta de la información y estado del candado.

Grupo de llamadas genérico sin configurar (placeholder del API Connector).

Grupo de llamadas genérico sin configurar (placeholder del API Connector).

Pasarela propia de Cityflow para los candados inteligentes Omni. Es el núcleo del control remoto de la flota: apertura/cierre, batería, alarma, luces, velocidad y GPS.

Candados Ortizma gestionados a través de la pasarela de candados de Cityflow: estado del dispositivo, auto-bloqueo y resolución de ubicación.

Proveedor antiguo de mensajería WhatsApp (obsoleto, sustituido por WasenderAPI).

Servicio de optimización de imágenes: comprime y reduce el peso de las fotos subidas.

Pasarela de pagos. Gestiona todo el ciclo de cobro: sesiones de checkout, clientes, métodos de pago guardados, cargos off-session, suscripciones y facturas.

Proveedor actual de mensajería WhatsApp para notificaciones a clientes.

Llamada genérica de WhatsApp (configuración auxiliar).

API oficial de WhatsApp Business (Meta): envío de mensajes de plantilla, como el aviso de inicio de reserva.