Referencia API

GET /v1/requests/:id

Recupera los detalles de una solicitud de análisis anterior por su ID.

Recupera los detalles completos de una solicitud de análisis enviada anteriormente, incluyendo los resultados de identificación del vehículo, métricas e información de errores.

Endpoint

GET https://api.ruedalens.com/v1/requests/:id

Autenticación

Requiere una clave de API válida en la cabecera Authorization. Solo puedes recuperar solicitudes que pertenezcan a tu cuenta.

Authorization: Bearer rdlns_sk_...

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`id`	`string`	Sí	El identificador único de la solicitud (devuelto como `requestId` del endpoint de análisis)

Ejemplo de solicitud

curl https://api.ruedalens.com/v1/requests/cmlecazi4000111qu590n9v6i \
  -H "Authorization: Bearer rdlns_sk_your_api_key_here"

Respuesta

Éxito — `200 OK`

{
  "success": true,
  "data": {
    "id": "cmlecazi4000111qu590n9v6i",
    "status": "success",
    "createdAt": "2026-02-08T22:54:03.962Z",
    "result": {
      "vehicles": [
        {
          "confidence": 0.98,
          "brand": "Lexus",
          "model": "NX",
          "trims": ["300h", "300"],
          "start_year": 2017,
          "end_year": 2021,
          "current_tire": {
            "tire_brand": "Bridgestone",
            "tire_model": "Dueler H/L 33",
            "width": 225,
            "aspect_ratio": 60,
            "diameter": 18,
            "load_index": "100",
            "speed_index": "H",
            "structure": "R",
            "runflat": null,
            "xl": null,
            "3pmsf": null,
            "tire_size": "225/60R18 100H"
          },
          "oe_front_tire": {
            "width": 225,
            "aspect_ratio": 60,
            "diameter": 18,
            "load_index": "100",
            "speed_index": "H",
            "structure": "R",
            "runflat": false,
            "xl": false,
            "tire_size": "225/60R18 100H"
          },
          "oe_rear_tire": {
            "width": 225,
            "aspect_ratio": 60,
            "diameter": 18,
            "load_index": "100",
            "speed_index": "H",
            "structure": "R",
            "runflat": false,
            "xl": false,
            "tire_size": "225/60R18 100H"
          },
          "pressure_front": 2.2,
          "pressure_rear": 2.2
        }
      ]
    },
    "metrics": {
      "executionTimeMs": 10364
    },
    "vehicle": {
      "brand": "Lexus",
      "model": "NX",
      "trims": ["300h", "300"],
      "year": "2017",
      "tireSize": "225/60R18 100H",
      "confidence": 0.98
    },
    "error": null
  },
  "timestamp": "2026-02-22T10:30:00.000Z"
}

Campos de la respuesta

Campo	Tipo	Descripción
`success`	`boolean`	Si la recuperación fue exitosa
`data.id`	`string`	Identificador único de la solicitud
`data.status`	`string`	Estado de la solicitud: `"success"` o `"error"`
`data.createdAt`	`string`	Marca de tiempo ISO 8601 de cuando se envió la solicitud originalmente
`data.result`	`object\|null`	Resultado completo del análisis (misma estructura que `data` de POST /v1/analyze). `null` si la solicitud falló
`data.metrics.executionTimeMs`	`number`	Tiempo de procesamiento del servidor en milisegundos
`data.vehicle`	`object\|null`	Resumen desnormalizado del vehículo para conveniencia. `null` si no se identificó ningún vehículo
`data.vehicle.brand`	`string\|null`	Fabricante del vehículo
`data.vehicle.model`	`string\|null`	Modelo del vehículo
`data.vehicle.trims`	`string[]`	Niveles de acabado disponibles
`data.vehicle.year`	`string\|null`	Primer año de producción de esta generación
`data.vehicle.tireSize`	`string\|null`	Cadena de tamaño de neumático formateada
`data.vehicle.confidence`	`number\|null`	Puntuación de confianza de la IA (0.0 a 1.0)
`data.error`	`object\|null`	Detalles del error si la solicitud falló. `null` en caso de éxito
`data.error.code`	`string`	Código de error (ej., `"RECOGNITION_FAILED"`)
`data.error.message`	`string`	Descripción del error legible por humanos
`timestamp`	`string`	Marca de tiempo ISO 8601 de esta respuesta

Result vs. Vehicle

El campo result contiene la salida completa del análisis (idéntica al campo data de POST /v1/analyze), mientras que vehicle proporciona un resumen plano de la coincidencia principal para acceso rápido. Usa result cuando necesites detalles completos (todas las coincidencias de vehículos, especificaciones de neumáticos, datos de presión) y vehicle para consultas simples.

Casos de uso

Este endpoint permite varios patrones de integración comunes:

Recuperación asíncrona: Almacena el requestId de una llamada de análisis y recupera los resultados más tarde
Auditoría: Revisa programáticamente los resultados de análisis anteriores para control de calidad
Construcción de dashboards: Obtén datos históricos de solicitudes para mostrarlos en paneles personalizados
Depuración: Referencia IDs de solicitudes específicas al investigar problemas

Retención de datos

Los datos de las solicitudes se conservan durante 30 días después del envío. Las solicitudes con más de 30 días de antigüedad pueden devolver una respuesta 404.

Respuestas de error

`401` No autorizado

Se devuelve cuando la clave de API falta o es inválida.

{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "Missing API key. Please provide a valid API key in the Authorization header."
  },
  "timestamp": "2026-02-22T10:30:00.000Z"
}

`404` No encontrado

Se devuelve cuando el ID de la solicitud no existe o no pertenece a tu cuenta.

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Request not found."
  },
  "timestamp": "2026-02-22T10:30:00.000Z"
}

Facturación

Este endpoint no cuenta para tu cuota mensual. Solo las solicitudes POST /v1/analyze consumen cuota.