GUÍA DE INTEGRACIÓN

Consulta vehículos desde tu servidor.

Autenticación

Crea una cuenta y copia tu clave desde Mi cuenta. Usa Authorization: Bearer TU_CLAVE o la cabecera X-API-Key. No pongas claves en URLs, HTML público ni JavaScript del navegador.

curl "https://TU_DOMINIO/api/search.php?brand=Abarth&model=124&y1=2018&y2=2018&limit=10" \
  -H "Authorization: Bearer TU_CLAVE"

Filtros y paginación

Parámetro	Uso
brand / brand_id	Marca exacta o identificador.
model / model_id	Parte del nombre o identificador.
cc, kw, cv	Valores numéricos exactos.
y1, y2	Solapamiento con el intervalo de años. Para un año concreto, usa ambos con el mismo valor.
limit	Entre 1 y 100; por defecto 50.
offset	Desde 0. Usa next_offset mientras has_more sea true.

{
  "results": [
    {"id": 1, "brand": "Abarth", "model": "124 Spider",
     "cc": 1368, "kw": 125, "cv": 170, "engine_code": "552 53 268",
     "year_start": 2018, "year_end": 2019, "fuel": null, "body": null}
  ],
  "count": 1, "limit": 10, "offset": 0,
  "has_more": false, "next_offset": null, "tokens_remaining": 99
}

Ejemplo ilustrativo de formato. Los resultados concretos dependen del catálogo.

Filtros del catálogo actualizado

generation, fuel, technology, engine: Valores de texto exactos.

fuel=Diésel&technology=TDI&engine=BKD

Saldo y límites

Cada respuesta 200 consume una consulta, aunque no haya coincidencias. Los errores no consumen saldo. El límite por minuto es compartido entre las claves del mismo usuario y se comprueba sobre los últimos 60 segundos.

Se gastan primero las consultas mensuales vigentes y después las adicionales compradas. Las recargas se conservan al renovar el mes. Los planes gratuitos se renuevan al usarlos o mediante el cron; los planes de pago solo se reponen tras un pago verificado. Si caduca el periodo, su saldo mensual deja de estar disponible.

HTTP	Significado
400	Filtros o intervalo de años no válidos.
401	Falta clave API.
402	No hay consultas disponibles.
403	Clave inactiva o suscripción sin acceso.
429	Límite por minuto; Retry-After: 60.
500 / 503	Error del servicio o conexión.

Alcance de los datos

Un año final null indica que el final no se conoce, y se trata como intervalo abierto al filtrar. No demuestra que el modelo siga fabricándose. Los rangos invertidos se excluyen hasta su revisión. Combustible, carrocería y otros campos pueden no estar informados. Estos datos no garantizan la compatibilidad de un recambio: esa relación debe aportarla y validarla la tienda.