La API de Wheelz ofrece soporte completo para la extracción de datos de fichas técnicas españolas. Nuestro sistema utiliza OCR avanzado e Inteligencia Artificial para extraer y validar todos los campos del documento, incluyendo información técnica detallada del vehículo, homologaciones y especificaciones.

Endpoint

POST https://api.wheelz-app.es/idp/ficha-tecnica

Autenticación

La autenticación se realiza mediante la cabecera x-api-key. La clave de la API se puede encontrar en el dashboard.

Ejemplos de uso

cURL

curl --location 'https://api.wheelz-app.es/idp/ficha-tecnica' \
--header 'x-api-key: whlz_pk_****' \
--form 'files=@"/ruta/al/archivo.jpg"'

curl --location 'https://api.wheelz-app.es/idp/ficha-tecnica' \
--header 'x-api-key: whlz_pk_****' \
--form 'files="https://mi-servidor.com/mi-documento.pdf"'

JavaScript (Axios)

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

async function uploadLocalFile(filePath) {
  const data = new FormData();
  data.append('files', fs.createReadStream(filePath));

  const config = {
    method: 'post',
    url: 'https://api.wheelz-app.es/idp/ficha-tecnica',
    headers: {
      'x-api-key': 'whlz_pk_****',
      ...data.getHeaders()
    },
    data: data
  };

  try {
    const response = await axios(config);
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

async function uploadFromUrl(fileUrl) {
  const data = new FormData();
  data.append('files', fileUrl);

  const config = {
    method: 'post',
    url: 'https://api.wheelz-app.es/idp/ficha-tecnica',
    headers: {
      'x-api-key': 'whlz_pk_****',
      ...data.getHeaders()
    },
    data: data
  };

  try {
    const response = await axios(config);
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

uploadLocalFile('/ruta/al/archivo.jpg');
uploadFromUrl('https://mi-servidor.com/mi-documento.pdf');

Respuesta de la API

La API devuelve un objeto JSON con un campo fields que contiene todos los campos de la ficha técnica. Los campos más relevantes incluyen:

Ejemplo de respuesta

{
  "fields": {
    "A1": "SKODA AUTO a.s.",
    "A2": "tr. Vaclava Klementa 869 Mlada Boleslav II 293 01 Mlada Boleslav",
    "B1": "null",
    "B2": "null",
    "CI": "SKO00ED88",
    "CL": "1033",
    "CV": "16",
    "D1": "SKODA",
    "D2": "NS/ACDFHAX1/NAD7AD7DL0035NS7N617",
    "D3": "KODIAQ",
    "D6": "EEE",
    "E": "TMBLK7NS5J8042922",
    "EP": "null",
    "EP1": "null",
    "EP2": "null",
    "EP3": "null",
    "EP4": "null",
    "F1": "2510",
    "F11": "1180 / 1390 / ----- / -----",
    "F15": "null",
    "F2": "2510",
    "F21": "1180 / 1390 / ----- / -----",
    "F3": "4510",
    "F31": "4510",
    "F4": "1655",
    "F5": "1882",
    "F51": "null",
    "F6": "4697",
    "F61": "null",
    "F7": "1586",
    "F71": "1576",
    "F8": "null",
    "F81": "null",
    "G": "1795",
    "G1": "null",
    "G2": "null",
    "J": "M1",
    "J1": "AC Familiar",
    "J2": "null",
    "J3": "null",
    "K": "e8*2007/46*0249*04",
    "K1": "null",
    "K2": "null",
    "L": "2/4",
    "L0": "null",
    "L1": "2 / Ant. + Post. / Conectable",
    "L2": "215/65 R17 99V",
    "M1": "2788 / ----- / -----",
    "M4": "null",
    "O1": "null",
    "O11": "null",
    "O12": "null",
    "O13": "2000",
    "O14": "750",
    "O21": "null",
    "O22": "null",
    "O23": "null",
    "O3": "null",
    "P1": "1968",
    "P11": "4 / En linea",
    "P2": "140",
    "P21": "13.19",
    "P3": "M/D",
    "P5": "DFH",
    "P51": "Volkswagen",
    "Q": "null",
    "R": "AZ",
    "S1": "7",
    "S11": "null",
    "S2": "null",
    "T": "null",
    "U1": "70",
    "U2": "2375",
    "V7": "151",
    "V8": "null",
    "V9": "EURO 6W",
    "Z": "null",
    "fecha_emision": "18/12/2017",
    "matricula": "4175KHJ",
    "num_certificado": "17V165878",
    "num_serie": "e002757100",
    "observaciones": "(L.2) 235/50 R19 99V; 235/55 R18 100V; 235/55 R18 100V M+S. -----",
    "opciones_incluidas_homologacion": "BARRAS LONGITUDINALES EN ORIGEN. TECHO ABRIBLE EN ORIGEN. (F.7) 1576. (F.7.1) 1566."
  }
}

Consideraciones importantes

• La API acepta imágenes en formato JPG, PNG y PDF
• Se puede enviar una única imagen de la ficha técnica
• Los documentos se procesan en tiempo real y no se almacenan
• Todas las conexiones están cifradas mediante SSL/TLS
• La API es resistente a variaciones en la calidad de la imagen
• Se recomienda enviar imágenes de alta calidad para mejor precisión en la extracción de datos