Konto

Wozu dieser Schlüssel dient

Holen/api/me

Die Fähigkeiten Ihres Schlüssels in einem Aufruf: aktivierte Funktionen, erlaubte Formate/Auflösungen/Seitenverhältnisse/Ansichten/Farben/Marken, Einschränkungen und Lieferinformationen (CDN-Host + signierte-URL Gültigkeitsdauer).

access gibt an, welchen API der Schlüssel verwendet — v1 Standardbilder, v2 Add-on, all beide — und queue_priority seine Priorität für neue Bilder (high, normal, low).

API v2 Add-on: mit dem Add-on fügt die Antwort addon hinzu: Formate, Gruppen, jede Add-on Option mit ihren Werten, Marken und ob ein Kennzeichenlogo eingerichtet ist (plate_logo).

Anfragen

curl "https://api.vehicleimagery.com/api/me" \
  -H "x-api-key: YOUR_API_KEY"

200 · Hauptfunktionen.

{
  "access": "all",
  "queue_priority": "normal",
  "addon": {
    "formats": [
      "png",
      "webp",
      "jpeg",
      "avif"
    ],
    "groups": [
      "hero",
      "steered",
      "extra",
      "drone",
      "360",
      "lifestyle"
    ],
    "options": {
      "lights": [
        "on",
        "off"
      ],
      "windows": [
        "see_through",
        "dark"
      ],
      "plate": [
        "none",
        "blank",
        "logo"
      ],
      "size": {
        "2k": 2560,
        "1080p": 1920,
        "720p": 1280,
        "540p": 960,
        "360p": 640,
        "thumb": 320
      }
    },
    "brands": [
      "*"
    ],
    "plate_logo": true
  },
  "features": {
    "shadow": true,
    "transparency": true,
    "mirroring": true,
    "grounding": true,
    "getall": true,
    "debug": false,
    "fallbacks": true,
    "watermark_forced": false
  },
  "allowed": {
    "formats": [
      "*"
    ],
    "resolutions": [
      "*"
    ],
    "ratios": [
      "*"
    ],
    "views": [
      "*"
    ],
    "colors": [
      "*"
    ],
    "brands": [
      "*"
    ]
  },
  "restrictions": {
    "blocked_brands": [],
    "year_range": null,
    "test_mode": false
  },
  "delivery": {
    "cdn": "cdn.vehicleimagery.com",
    "signed_url_ttl_seconds": 604800
  }
}

401 · Fehlender oder ungültiger `x-api-key`.

{
  "error": "Invalid API key"
}

403 · Planbeschränkung (Funktion, Format oder Marke nicht erlaubt) oder blockierter Anfrage.

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

404 · Keine Daten für den angeforderten Pfad.

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