Comenzar

Primeros pasos

Realiza tu primera llamada a la API de Rueda Lens en minutos.

Esta guía te acompaña paso a paso para realizar tu primera llamada a la API de Rueda Lens.

Crear una cuenta

Visita dashboard.ruedalens.com
Regístrate con tu dirección de correo electrónico
Verifica tu correo mediante el código OTP enviado a tu bandeja de entrada

Generar una clave de API

Accede a la página API Keys en tu panel
Haz clic en Create New Key
Asigna a la clave un nombre descriptivo (por ejemplo, "Producción", "Pruebas")
Copia y guarda tu clave de API de forma segura — comienza por rdlns_sk_

Importante

Las claves de API solo se muestran una vez durante su creación. Guárdalas de forma segura.

Realizar tu primera solicitud

La API soporta dos modos de reconocimiento: simple (solo imagen del neumático) y dual (neumático + vehículo). El modo dual ofrece la mayor precisión en identificación de vehículos.

curl -X POST https://api.ruedalens.com/v1/analyze \
  -H "Authorization: Bearer rdlns_sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "dual",
    "tireImage": "/9j/4AAQSkZJRg...",
    "carImage": "/9j/4AAQSkZJRg..."
  }'

Alternativa en modo simple

Para una integración más sencilla con una sola foto, usa "mode": "single" con un campo "image". Consulta la Referencia de la API para detalles sobre ambos modos.

Entender la respuesta

Una respuesta correcta tiene este aspecto:

{
  "success": true,
  "requestId": "cmlecazi4000111qu590n9v6i",
  "mode": "dual",
  "data": {
    "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
        },
        "oe_front_tire": {
          "width": 225,
          "aspect_ratio": 60,
          "diameter": 18,
          "load_index": "100",
          "speed_index": "H",
          "structure": "R",
          "runflat": false,
          "xl": false
        },
        "oe_rear_tire": {
          "width": 225,
          "aspect_ratio": 60,
          "diameter": 18,
          "load_index": "100",
          "speed_index": "H",
          "structure": "R",
          "runflat": false,
          "xl": false
        },
        "pressure_front": 2.2,
        "pressure_rear": 2.2
      }
    ]
  },
  "metrics": {
    "executionTimeMs": 10364
  },
  "timestamp": "2026-02-08T22:54:03.962Z"
}

La respuesta incluye:

vehicles: array de coincidencias de vehículos identificados (ordenados por nivel de confianza)
requestId: identificador único para el seguimiento de esta solicitud
metrics: información de rendimiento, incluido el tiempo de ejecución

Próximos pasos

Aprende sobre la autenticación: gestión de claves de API y buenas prácticas
Explora la referencia de la API: documentación completa de los endpoints
Entiende la limitación de solicitudes: planes, cuotas y facturación por excedentes

Herramientas para desarrolladores

Colección de Postman

Descarga nuestra colección oficial de Postman para probar la API rápidamente:

Descargar colección de Postman

Incluye:

Solicitudes preconfiguradas para todos los endpoints
Ejemplos de cuerpos de solicitud y respuesta
Tests automatizados para validar las respuestas
Configuración de variables de entorno

Configuración:

Importa la colección en Postman
Configura tu RUEDA_LENS_API_KEY en las variables de la colección
Empieza a probar inmediatamente