Feed de rutas y precios para un marketplace

get/api/v1/feed/{formato}con clave

Rutas con precio por categoría de vehículo, tiempo y antelación mínima, al precio de la clave que llama. Formatos: «csv» (columnas genéricas del sector) y «json». Requiere una clave con la marca «feed» y con un modo de precio que descuente algo: a precio público la comisión del marketplace saldría de nuestro margen y se contesta 409. No publica disponibilidad: cada fila sale como «bajo_confirmacion» con su antelación mínima. Solo se publican rutas cuyo precio respaldaría el sistema en una reserva real —ni distancias estimadas, ni el precio de una flota con tarifa propia—; lo descartado viaja en «descartadas» (JSON) o en las cabeceras X-VTC-Feed-* (CSV).

Parámetros

Nombre	En	Tipo	Descripción
formato *	path	"csv" \| "json"
provincia	query	string	Slug de provincia, o «todas»

Respuestas

200Feed
403La clave no tiene el feed habilitado
404Formato no disponible
409La clave trabaja a precio público

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 GET "https://ridelta.com/api/v1/feed/csv" \
  -H "Authorization: Bearer $RIDELTA_API_KEY"

JavaScript (fetch)

const respuesta = await fetch("https://ridelta.com/api/v1/feed/csv", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.RIDELTA_API_KEY}`,
  },
});
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(
    "GET",
    "https://ridelta.com/api/v1/feed/csv",
    headers={"Authorization": f"Bearer {os.environ['RIDELTA_API_KEY']}"},
    timeout=15,
)
respuesta.raise_for_status()
datos = respuesta.json()

PHP (cURL)

<?php
$ch = curl_init('https://ridelta.com/api/v1/feed/csv');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RIDELTA_API_KEY')],
]);
$datos = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);