Feed de datos del afiliado: catálogo atribuido o conversiones

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

Con «tipo=catalogo» (por defecto), las rutas con su precio «desde» y dos enlaces por fila —la página de la ruta y el pedido con el trayecto puesto—, los dos por /r/<código> del afiliado que llama y con su «subid». Con «tipo=conversiones», sus conversiones sin datos del pasajero. La atribución sale de la clave «afi_» en la cabecera o del token de solo lectura «fd_» en la URL (para Google Sheets, WP All Import y lectores que no mandan cabeceras), nunca de un parámetro; el token caduca al regenerar o revocar la clave.

Parámetros

Nombre	En	Tipo	Descripción
formato *	path	"csv" \| "xml" \| "json"
tipo	query	"catalogo" \| "conversiones"
token	query	string	Token de feed del panel, si no se manda la clave
subid	query	string	Etiqueta de seguimiento de los enlaces
provincia	query	string	Slug de provincia, o «todas»
dias	query	integer	Ventana de las conversiones

Respuestas

200Feed en el formato pedido
401Sin clave ni token, o token no válido o caducado
404Formato no disponible
429Demasiadas peticiones o demasiados tokens fallidos
503El servidor no puede comprobar tokens (sin secreto configurado)

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/afiliado/feed/csv" \
  -H "Authorization: Bearer $RIDELTA_API_KEY"

JavaScript (fetch)

const respuesta = await fetch("https://ridelta.com/api/v1/afiliado/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/afiliado/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/afiliado/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);