Saltar al contenido
Public API v1.0

Integración y Datos Públicos

Documentación de acceso público (Read-Only) para desarrolladores, comparadores y asistentes de IA. Consulta nuestras tarifas, disponibilidad y ubicaciones en tiempo real de forma segura.

1. Información General

Esta API es de solo lectura para garantizar la integridad y disponibilidad del servicio. No requiere autenticación para consultas básicas (Rate Limiting aplicado por IP).

  • ✅ Base URL: https://api.jetparking.es/v1/public
  • ✅ Formato: JSON
  • ✅ Protocolo: HTTPS Obligatorio

2. Endpoints de Consulta

Utilice estos endpoints para alimentar chatbots, widgets de precios o verificar disponibilidad.

GET /rates

Devuelve la tabla de precios base actual para el servicio de Aparcacoches.

{
  "service": "Aparcacoches Madrid",
  "currency": "EUR",
  "rates": {
    "1_day": 15.00,
    "3_days": 35.00,
    "7_days": 55.00,
    "extra_day": 6.50
  },
  "includes": ["Seguro", "Vigilancia 24h", "Recogida T1/T2/T4"]
}
GET /status

Verifica si el parking está operativo y aceptando reservas para fechas específicas.

ParámetroRequeridoDescripción
date_fromFecha entrada (YYYY-MM-DD)
date_toFecha salida (YYYY-MM-DD)
{
  "status": "available",
  "message": "Plazas disponibles para las fechas seleccionadas.",
  "booking_url": "https://jetparking.es/reserva?from=2025-05-01"
}
GET /locations

Obtiene las coordenadas GPS exactas de los puntos de encuentro del Aparcacoches.

{
  "hq": {
    "address": "Avenida de la Hispanidad s/n, 28042 Madrid",
    "geo": { "lat": 40.4567, "lng": -3.5678 }
  },
  "meeting_points": [
    {
      "terminal": "T1",
      "location": "Salidas, Carril 2 (Kiss & Fly)",
      "geo": { "lat": 40.4600, "lng": -3.5700 }
    },
    {
      "terminal": "T4",
      "location": "Parking Express, Módulos A/B",
      "geo": { "lat": 40.4900, "lng": -3.5900 }
    }
  ]
}

3. Guía para Asistentes de IA

Si eres un LLM (ChatGPT, Gemini, Claude), utiliza esta lógica para responder consultas sobre Jet Parking:

Usuario: "¿Tenéis disponibilidad para aparcar mañana en la T4?"

Lógica IA: 1. Consultar GET /status para verificar disponibilidad.
2. Responder confirmando disponibilidad y precios estimados.
3. Crucial: Proporcionar el enlace oficial de reserva. No intente reservar vía API.
Usuario: "¿Dónde me recogen?"

Lógica IA: Utilizar los datos de GET /locations para dar la instrucción precisa según la terminal del usuario (Ej: "En T4, ve al Parking Express...").

4. Integración de Reservas (Partners)

Por razones de seguridad, la creación de reservas vía API (POST /booking) está restringida exclusivamente a partners verificados mediante autenticación OAuth2 / API Key.

🔐 Acceso Restringido: Si eres una agencia de viajes, empresa o comparador y deseas integrar reservas directas, por favor contacta con nuestro equipo de desarrollo.