Referencia · Proveedores

Solicitud de alta de una empresa de traslados desde un canal

post/api/v1/proveedorescon clave

La misma solicitud de flota que la del formulario público: queda en la cola de captación de flotas con el origen api:<etiqueta de la clave>, y la empresa puede dar servicio a todo lo que se vende, no solo al canal.

Cuerpo

Campo	Tipo	Descripción
kind	"VTC" \| "TAXI" \| "MIXTA"
legalName *	string
tradeName	string
nif	string
contactName *	string
email *	string (email)
phone *	string
province	string
municipalities	string
vehicles	integer
drivers	integer
vtcAuthorizations	integer
taxiLicenses	integer
message	string

* obligatorio

Respuestas

201Solicitud registrada: referencia es su identificador
400Datos incompletos
401Clave no válida

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/proveedores" \
  -H "Authorization: Bearer $RIDELTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"legalName":"Traslados Ejemplo S.L.","contactName":"Luis Gómez","email":"reservas@hotel.example","phone":"+34600000000"}'

JavaScript (fetch)

const respuesta = await fetch("https://ridelta.com/api/v1/proveedores", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RIDELTA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "legalName": "Traslados Ejemplo S.L.",
    "contactName": "Luis Gómez",
    "email": "reservas@hotel.example",
    "phone": "+34600000000"
  }),
});
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/proveedores",
    headers={"Authorization": f"Bearer {os.environ['RIDELTA_API_KEY']}"},
    json={"legalName":"Traslados Ejemplo S.L.","contactName":"Luis Gómez","email":"reservas@hotel.example","phone":"+34600000000"},
    timeout=15,
)
respuesta.raise_for_status()
datos = respuesta.json()

PHP (cURL)

<?php
$ch = curl_init('https://ridelta.com/api/v1/proveedores');
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(['legalName' => 'Traslados Ejemplo S.L.', 'contactName' => 'Luis Gómez', 'email' => 'reservas@hotel.example', 'phone' => '+34600000000']),
]);
$datos = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);