GUIDE D'INTÉGRATION

Vérifiez les véhicules depuis votre serveur.

Authentification

Créez un compte et copiez votre mot de passe depuis Mon compte. Utiliser Authorization: Bearer TU_CLAVE ou l'en-tête X-API-Key. Ne placez pas de clés dans les URL, le HTML public ou le JavaScript du navigateur.

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

Filtres et pagination

Paramètre	Utiliser
brand / brand_id	Marque ou identifiant exact.
model / model_id	Partie du nom ou de l'identifiant.
cc, kw, cv	Valeurs numériques exactes.
y1, y2	Chevauchement avec l'intervalle des années. Pour une année spécifique, utilisez les deux avec la même valeur.
limit	Entre 1 et 100 ; par défaut 50.
offset	À partir de 0. Utilisez next_offset pendant que has_more est vrai.

{
  "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
}

Exemple illustratif de format. Les résultats spécifiques dépendent du catalogue.

Filtres du catalogue mis à jour

generation, fuel, technology, engine: Valeurs textuelles exactes.

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

Equilibre et limites

Chaque 200 réponses consomme une requête de base de données, même s'il n'y a aucune correspondance. Les erreurs ne consomment pas l’équilibre. La limite par minute est partagée entre les clés d'un même utilisateur et est vérifiée sur les 60 dernières secondes.

Les requêtes mensuelles actuelles de la base de données sont dépensées en premier, puis les requêtes supplémentaires achetées. Les recharges sont conservées lors du renouvellement du mois. Les forfaits gratuits se renouvellent lors de leur utilisation ou via cron ; Les plans de paiement ne sont réapprovisionnés qu'après un paiement vérifié. Si le délai expire, votre solde mensuel n'est plus disponible.

HTTP	Signification
400	Filtres ou plage d'années non valides.
401	Clé API manquante.
402	Aucune requête de base de données disponible.
403	Clé inactive ou abonnement sans accès.
429	Limite par minute ; Réessayer après : 60.
500 / 503	Erreur de service ou de connexion.

Portée des données

Une année finale nulle indique que l’année finale n’est pas connue et est traitée comme une plage ouverte lors du filtrage. Cela ne prouve pas que le modèle soit toujours en fabrication. Les plages inversées sont exclues en attendant leur examen. Le carburant, la carrosserie et d'autres champs peuvent ne pas être déclarés. Ces données ne garantissent pas la compatibilité d'une pièce détachée : cette relation doit être fournie et validée par le magasin.