Referência

Todas as opções de entrega agrupadas

GET/api/options

Tudo que você pode solicitar, filtrado por plano, em uma única chamada: formatos, larguras, qualidade, proporções, resoluções, a opção color e as flags de modificador (sombra/transparência/solo/espelhamento/carimbo d'água) com a permissão do seu plano para cada uma.

Solicitar

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

200 · Opções em pacote.

{
  "formats": [
    "png",
    "webp",
    "jpeg",
    "avif"
  ],
  "widths": [
    200,
    400,
    800,
    1200,
    1600,
    2000
  ],
  "quality": {
    "min": 40,
    "max": 100,
    "default": 82
  },
  "modifiers": {
    "shadow": {
      "param": "shadow",
      "values": [
        "true",
        "false"
      ],
      "allowed": true
    },
    "mirroring": {
      "param": "mirroring",
      "values": [
        "true",
        "clean"
      ],
      "allowed": true,
      "note": "floor reflection; needs a transparent variant; shadow=false drops the underbody"
    }
  },
  "params": [
    "format",
    "resolution",
    "ratio",
    "width",
    "height",
    "quality",
    "color",
    "shadow",
    "transparency",
    "ground",
    "mirroring"
  ]
}

401 · `x-api-key` ausente ou inválida.

{
  "error": "Invalid API key"
}

403 · Restrição de plano (recurso, formato ou marca não permitido) ou solicitação bloqueada.

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

404 · Nenhum dado para o caminho solicitado.

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