مرجع

جميع خيارات التوصيل مجمعة

GET/api/options

كل ما يمكنك طلبه، مرشح حسب الخطة، في مكالمة واحدة: التنسيقات، العرض، الجودة، النسبة، الدقة، خيار color وأعلام التعديل (الظل/الشفافية/الأرض/التعكس/العلامة المائية) مع ما إذا كانت خطتك تسمح بكل منها.

إضافة API v2: مع الإضافة، يتم إضافة قسم addon إلى الرد: تنسيقات الإضافة، كل خيار إضافي يمكن أن يستخدمه مفتاحك مع قيمه (lights, background, color, windows, plate, fit, size, hotspots) والمجموعات.

طلب

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

200 · خيارات مجمعة.

{
  "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"
  ],
  "addon": {
    "formats": [
      "png",
      "webp",
      "jpeg",
      "avif"
    ],
    "options": {
      "lights": {
        "param": "lights",
        "values": [
          "on",
          "off"
        ]
      },
      "windows": {
        "param": "windows",
        "values": [
          "see_through",
          "dark"
        ]
      },
      "size": {
        "param": "size",
        "values": {
          "2k": 2560,
          "1080p": 1920,
          "720p": 1280,
          "540p": 960,
          "360p": 640,
          "thumb": 320
        }
      }
    },
    "groups": [
      "hero",
      "steered",
      "extra",
      "drone",
      "360",
      "lifestyle"
    ]
  }
}

401 · مفتاح `x-api-key` مفقود أو غير صالح.

{
  "error": "Invalid API key"
}

403 · قيود الخطة (الميزة أو التنسيق أو العلامة التجارية غير مسموح بها) أو طلب محظور.

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

404 · لا يوجد بيانات للمسار المطلوب.

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