Cancela una reserva propia

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

Solo las reservas que entraron con esta misma clave. Aplica la política de cancelación publicada y devuelve lo que corresponda.

Parámetros

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

Cuerpo

Campo	Tipo	Descripción
motivo	string

* obligatorio

Respuestas

200Cancelada, con el detalle de la devolución
403La reserva no es de esta clave
404No encontrada
409Ya cancelada o servicio en marcha

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/cancelar" \
  -H "Authorization: Bearer $RIDELTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

JavaScript (fetch)

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

PHP (cURL)

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