Crear una reserva

post/api/v1/reservascon clave

Registra la contratación previa. La reserva queda atribuida al partner de la clave. Devuelve el código de seguimiento.

Con stops, el alta corta: si el régimen de tarifa no admite las paradas, o si una de ellas convierte un tramo del recorrido en un trayecto urbano que la autorización no habilita, contesta 422 con el motivo y no crea nada. El presupuesto informa; esta es la puerta que no se puede saltar.

Parámetros

Nombre	En	Tipo	Descripción
X-Market-Id	header	string	El mercado en el que se presupuesta o reserva (`GLO-12`): uno de los `id` de `GET /api/mercados`. Sin cabecera, el mercado lo decide el dominio por el que se entra, y en los de Castilla-La Mancha es el de casa. Los importes vuelven en la moneda del mercado. Una clave acotada a unos mercados recibe 403 fuera de ellos.

Cuerpo `ReservaPeticion`

Campo	Tipo	Descripción
fullName *	string
phone *	string
email *	string (email)
originAddress *	string
originMunicipality *	string
destinationAddress *	string
destinationMunicipality *	string
pickupAt *	string
returnAt	string	Vuelta, si se contrata a la vez. Con precio cerrado la vuelta se guarda como otra reserva y las dos se pagan con un solo cobro: la respuesta trae su código en `vuelta`.
passengers	integer
hours	number	Horas contratadas, solo en serviceType DISPOSICION o EVENTO. Con horas el precio sale de la tarifa por hora.
luggage	integer
childSeats	integer
pets	boolean
flightNumber	string
notes	string
travelsOther	boolean	Viaja otra persona (huésped, paciente, familiar). Sin mandarlo basta con enviar passengerName o passengerPhone; con false se ignoran los dos.
passengerName	string	Nombre de quien viaja, si no es quien contrata. Es el que ve el conductor y el que va en el cartel del aeropuerto.
passengerPhone	string	Teléfono de quien viaja: al que llama el conductor y por el que se le avisa. Quien contrata sigue siendo fullName/phone, y suya es la factura.
cobroDelCanal	boolean	Solo con una clave con la marca `cobra` (ADR 0405): el canal cobra al cliente por su cuenta. La reserva nace como pago en línea esperando el cobro, sin pasarela aquí, y se confirma cuando el canal lo comunica en `POST /api/v1/reservas/{code}/pago`. Sin la marca, `403`.
paymentMethod	"EFECTIVO" \| "TARJETA_A_BORDO" \| "TRANSFERENCIA" \| "PAGO_ONLINE" \| "FACTURA_EMPRESA"
originLat	number
originLng	number
originProvince	string
originRegion	string
destinationLat	number
destinationLng	number
destinationProvince	string
destinationRegion	string
stops	Parada[]	Las mismas paradas que en el presupuesto. Si no caben en el régimen que rige el trayecto, o si una de ellas convierte un tramo en urbano, el alta contesta `422` y no crea la reserva.
privacyAccepted *	boolean	Consentimiento del pasajero, obligatorio (RGPD)

* obligatorio

Respuestas

201Reserva creada
400Datos incompletos
401Clave no válida
409Horario no disponible
422Trayecto fuera de ámbito, o paradas que no caben. El cuerpo lleva error con el motivo y, cuando son las paradas, stops.code y stops.reason: el código del régimen de tarifa (precio_cerrado, fuera_del_municipio, sin_precio_de_espera) o fuera_de_ambito cuando una parada convierte un tramo del recorrido en un trayecto que la autorización no habilita, y entonces stops.leg dice cuál.

Qué hacer con cada error: errores, límites y reintentos.

Ejemplos

La clave va en la variable de entorno RIDELTA_API_KEY, nunca escrita en el código.

cURL

curl -X POST "https://ridelta.com/api/v1/reservas" \
  -H "Authorization: Bearer $RIDELTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Ana Pérez","phone":"+34600000000","email":"reservas@hotel.example","originAddress":"Plaza Mayor 1","originMunicipality":"Illescas","destinationAddress":"Aeropuerto Madrid-Barajas T4","destinationMunicipality":"Madrid","pickupAt":"2026-12-04T05:30","privacyAccepted":true}'

JavaScript (fetch)

const respuesta = await fetch("https://ridelta.com/api/v1/reservas", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RIDELTA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "fullName": "Ana Pérez",
    "phone": "+34600000000",
    "email": "reservas@hotel.example",
    "originAddress": "Plaza Mayor 1",
    "originMunicipality": "Illescas",
    "destinationAddress": "Aeropuerto Madrid-Barajas T4",
    "destinationMunicipality": "Madrid",
    "pickupAt": "2026-12-04T05:30",
    "privacyAccepted": true
  }),
});
if (!respuesta.ok) throw new Error(`${respuesta.status}: ${await respuesta.text()}`);
const datos = await respuesta.json();

Python (requests)

import os
import requests

respuesta = requests.request(
    "POST",
    "https://ridelta.com/api/v1/reservas",
    headers={"Authorization": f"Bearer {os.environ['RIDELTA_API_KEY']}"},
    json={"fullName":"Ana Pérez","phone":"+34600000000","email":"reservas@hotel.example","originAddress":"Plaza Mayor 1","originMunicipality":"Illescas","destinationAddress":"Aeropuerto Madrid-Barajas T4","destinationMunicipality":"Madrid","pickupAt":"2026-12-04T05:30","privacyAccepted":True},
    timeout=15,
)
respuesta.raise_for_status()
datos = respuesta.json()

PHP (cURL)

<?php
$ch = curl_init('https://ridelta.com/api/v1/reservas');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RIDELTA_API_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['fullName' => 'Ana Pérez', 'phone' => '+34600000000', 'email' => 'reservas@hotel.example', 'originAddress' => 'Plaza Mayor 1', 'originMunicipality' => 'Illescas', 'destinationAddress' => 'Aeropuerto Madrid-Barajas T4', 'destinationMunicipality' => 'Madrid', 'pickupAt' => '2026-12-04T05:30', 'privacyAccepted' => true]),
]);
$datos = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);

Crear una reserva

Parámetros

Cuerpo ReservaPeticion

Respuestas

Ejemplos

Cuerpo `ReservaPeticion`