Catalogue

Dépôt en vrac de toutes les configurations

GET/api/getall

Toutes les configurations disponibles pour votre clé dans une réponse (volumineuse) - une entrée par voiture et couleur (chaque voiture liste les couleurs de la maison plus celles de la marque). Accès selon le plan. Utilisez pour une synchronisation ponctuelle plutôt que par requête.

Add-on de l'API v2: avec l'add-on, les voitures avec des images d'add-on sont incluses aussi et portent groups, par exemple { id: 900000003, path: "Audi/Q9/2026/SUV/Default", views: ["front", "front_left", …], groups: [{ group: "hero", images: 8 }, { group: "360", images: 64 }, { group: "lifestyle", images: 14 }] }. Les voitures qui existent uniquement dans l'add-on ont des ids à partir de 900000000

Paramètres de requête.

Nom	Type	Description
`version`	chaîne	Résultats d'une seule version: `v1` = images standard, `v2` = add-on API v2 (pas de retour aux images standard). Sans cela: tout ce que votre clé permet. Non autorisé pour votre clé → `403`. `v1v2`

Demande

curl "https://api.vehicleimagery.com/api/getall?version=v1" \
  -H "x-api-key: YOUR_API_KEY"

200 · Toutes les configurations.

[
  {
    "id": 911,
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "variant": "Basis",
    "trim": "base",
    "year": 2016,
    "resolution": "default",
    "format": "png",
    "color": "default"
  },
  {
    "id": 911,
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "variant": "Basis",
    "trim": "base",
    "year": 2016,
    "resolution": "default",
    "format": "png",
    "color": "wine_red"
  }
]

401 · Clé `x-api-key` manquante ou invalide.

{
  "error": "Invalid API key"
}

403 · Restriction de plan (fonctionnalité, format ou marque non autorisés) ou demande bloquée.

{
  "error": "Mirroring is not allowed by your plan."
}

404 · Aucune donnée pour le chemin demandé.

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}