مرجع

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

GET/api/options

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

طلب

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

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