La API de Wheelz ofrece soporte completo para la extracción de datos de permisos de circulación españoles. Nuestro sistema utiliza OCR avanzado e Inteligencia Artificial para extraer y validar todos los campos del documento, incluyendo información del vehículo, titular y datos técnicos.

Endpoint

POST https://api.wheelz-app.es/idp/permiso-circulacion

Autenticación

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

Parámetros de la petición

La API acepta dos formas de enviar el documento:

• files: Archivo del permiso de circulación (formato multipart/form-data)
• url: URL pública del permiso de circulación (formato application/json)

Ejemplos de uso

cURL (Archivo)

curl --location 'https://api.wheelz-app.es/idp/permiso-circulacion' \
--header 'x-api-key: tu-clave-api' \
--form 'files=@"/ruta/al/permiso.jpg"'

cURL (URL)

curl --location 'https://api.wheelz-app.es/idp/permiso-circulacion' \
--header 'Content-Type: application/json' \
--header 'x-api-key: tu-clave-api' \
--data '{
  "url": "https://ejemplo.com/permiso.jpg"
}'

JavaScript (Axios - Archivo)

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

const data = new FormData();
data.append('files', fs.createReadStream('/ruta/al/permiso.jpg'));

const config = {
  method: 'post',
  url: 'https://api.wheelz-app.es/idp/permiso-circulacion',
  headers: {
    'x-api-key': 'tu-clave-api',
    ...data.getHeaders()
  },
  data: data
};

axios(config)
  .then((response) => console.log(response.data))
  .catch((error) => console.error(error));

JavaScript (Axios - URL)

const axios = require('axios');

const config = {
  method: 'post',
  url: 'https://api.wheelz-app.es/idp/permiso-circulacion',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'tu-clave-api'
  },
  data: {
    url: 'https://ejemplo.com/permiso.jpg'
  }
};

axios(config)
  .then((response) => console.log(response.data))
  .catch((error) => console.error(error));

Respuesta de la API

La API devuelve un objeto JSON con los siguientes campos:

Ejemplo de respuesta

{
  "fields": {
    "A": "4175KHJ",
    "I": "08-02-2018",
    "I.1": "08-07-2022",
    "I.2": "TOLEDO",
    "C.1.1": "VAZQUEZ MENDEZ",
    "C.1.2": "ALBERT",
    "C.1.3": null,
    "C.4": null,
    "D.1": "SKODA",
    "D.2": "NS/ACDFHAX1/NAD7AD7DL0035NS7N617",
    "D.3": "KODIAQ",
    "D.4": "PART-SIN ESPECIFICAR",
    "E": "TMBLK7NS5J8042922",
    "F.1": 2510,
    "F.2": 2510,
    "G": 1795,
    "K": "E8*2007/46*0249*04",
    "P.1": 1968,
    "P.2": 140,
    "P.3": "DIESEL",
    "Q": null,
    "S.1": 7,
    "S.2": null,
    "KM": 92794,
    "KM_DATE": "28-01-2022"
  }
}

Consideraciones importantes

• La API acepta imágenes en formato JPG, PNG y PDF
• Se puede enviar una única imagen del permiso de circulación
• 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