Documentación API

API REST sobre HTTPS. Autenticación Bearer. Todas las respuestas en JSON.

Base URL

https://ridezio.com/api/v1

Autenticación

Incluye tu API key en cada request como Bearer token:

Authorization: Bearer rz_live_YOUR_API_KEY

Sin API key activa → obtén acceso aquí.

Rate Limiting

20 peticiones/minuto por IP. Si se supera, respuesta 429 con cabeceras Retry-After y X-RateLimit-Remaining.

Endpoints

POST/api/v1/requests🔑 Auth

Crear una petición de transfer

Body

{
  "pickup_location": "Aeropuerto de Palma (PMI)",
  "dropoff_location": "Hotel Meliá Palma Bay",
  "pickup_datetime": "2026-05-10T14:30:00Z",
  "passengers": 2,
  "city": "mallorca"
}

Response

{
  "request": {
    "id": "req_01HXZ...",
    "status": "active",
    "offers": []
  }
}

GET/api/v1/requests/:id🔑 Auth

Estado de una petición y ofertas recibidas

Response

{
  "request": {
    "id": "req_01HXZ...",
    "status": "active",
    "offers": [
      {
        "id": "offer_...",
        "driver_name": "Carlos M.",
        "price": 45,
        "currency": "EUR",
        "vehicle": "Mercedes E-Class"
      }
    ]
  }
}

Códigos de error

400Bad Request — faltan campos obligatorios

401Unauthorized — API key inválida o ausente

403Forbidden — sin permisos para este recurso

404Not Found — recurso no encontrado

429Too Many Requests — límite de rate excedido

500Internal Server Error — error en el servidor

¿Necesitas ayuda con la integración?

Contactar soporte técnico