Cambia la hora de una reserva propia

post/api/v1/reservas/{code}/horacon clave

Con previsualizar: true solo contesta si es posible y con qué importe. Sin eso, mueve la reserva. No se mueve si la hoja de ruta ya está emitida, si el servicio está en marcha, si la hora nueva no está disponible, o si está pagada y la hora nueva es más cara.

Parámetros

Nombre	En	Tipo	Descripción
code *	path	string	Código de seguimiento

Cuerpo

Campo	Tipo	Descripción
recogidaEn *	string	Fecha y hora locales de la recogida nueva
previsualizar	boolean

* obligatorio

Respuestas

200Hora nueva, importe y si ha quedado sin conductor
403La reserva no es de esta clave
404No encontrada
409No se puede mover: el motivo va en la respuesta

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/VTC-7K2Q/hora" \
  -H "Authorization: Bearer $RIDELTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recogidaEn":"2026-09-20T07:30"}'

JavaScript (fetch)

const respuesta = await fetch("https://ridelta.com/api/v1/reservas/VTC-7K2Q/hora", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RIDELTA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "recogidaEn": "2026-09-20T07:30"
  }),
});
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/VTC-7K2Q/hora",
    headers={"Authorization": f"Bearer {os.environ['RIDELTA_API_KEY']}"},
    json={"recogidaEn":"2026-09-20T07:30"},
    timeout=15,
)
respuesta.raise_for_status()
datos = respuesta.json()

PHP (cURL)

<?php
$ch = curl_init('https://ridelta.com/api/v1/reservas/VTC-7K2Q/hora');
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(['recogidaEn' => '2026-09-20T07:30']),
]);
$datos = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);