أسئلة وإجاباتها

تحوّل وصف مركبة إلى صورة استوديو بجودة التصوير. ترسل العلامة والطراز والسنة والنسخة والفئة، أو رقم هيكل أو لوحة، فتحصل على رابط صورة موقّع يمكنك وضعه مباشرةً في وسم img. بلا جلسة تصوير ولا مكتبة صور ولا معالجة لاحقة.

مفتاح واجهة في ترويسة x-api-key، لا أكثر. الفهرس كله مسار عنوان، فيمكنك استكشافه بـ curl قبل كتابة أي سطر برمجي. التوثيق يبدأ بطلب يعمل فعلًا.

GET /api/search?q=vw+golf يطابق النص الحر مع كل علامة وطراز، ويتسامح مع الأسماء الدارجة والأخطاء الإملائية والمسافات غير المعتادة. يردّ بمسارات من الفهرس يمكنك متابعة السير فيها. أما وضع سنة في الاستعلام فلن يطابق شيئًا، فالسنوات تأتي في مستوى أعمق.

نعم. صفحة الأمثلة سوق تجريبي حيّ: كل صورة فيها تُجلب من الواجهة أثناء تصفّحك، ويمكنك بنفسك تبديل الزاوية وإعادة طلاء السيارة وتغيير الخلفية. وإن أردتها على مركباتك أنت، أرسل إلينا بضعًا منها وسنعود بالصور، في يوم العمل نفسه عادةً.

توجد حزمة على npm وخادم MCP لوكلاء الذكاء الاصطناعي. وكلاهما غير إلزامي. فهي نقطة نهاية HTTPS تعيد رابط صورة، وهذا شيء تعرف كل منصّة التعامل معه سلفًا.

تحصل معظم الفرق على صورة في صفحة في اليوم نفسه الذي تستلم فيه المفتاح، لأن الربط مجرّد عنوان. والانتقال من هناك إلى الإنتاج مسألة أين تخزّن مؤقتًا، لا كم سطرًا تكتب.

100 علامة تجارية وأكثر من 65,000 طراز، من سنوات حالية وسابقة. GET /api/brands يعيد القائمة الفعلية لمفتاحك في أي وقت، فلا حاجة إلى تصديق رقم على صفحة تسويقية. اطّلع على التغطية.

الأجيال السابقة مشمولة، وهذا أهم مما يُظن: فإعلانات المستعمل وفهارس إعادة التسويق وأدلة الشراء تدور غالبًا حول سيارات غادرت صالات العرض منذ سنوات. GET /api/{brand}/{model} يعرض كل سنوات الطراز المتاحة له.

لا. الشاحنات الصغيرة والمركبات التجارية والبيك أب والدرّاجات النارية تُصيَّر بالمظهر الاستوديوي نفسه، فتظل صفحة الأسطول المختلطة تُقرأ كفهرس واحد. ولهذا بالضبط توجد درّاجة نارية في شبكة صفحة الأمثلة.

الواجهة تخبرك بدل أن تخمّن، فتحصل على تفرّع في شيفرتك بدل سيارة خاطئة في صفحتك. وحين لا توجد سنة الطراز المطلوبة، تنتقل إلى أقرب جيل متاح وتذكر ذلك في errornotes.

باستمرار، مع توفّر بيانات الصانع. وهذا هو الأهم للتأجير التمويلي والمهيّئات: فالطراز يوجد في الفهرس عادةً قبل أشهر من إنتاج أول وحدة، وهو الوقت نفسه الذي تحتاجه فيه صفحة العرض.

نعم، GET /api/getall يُخرج كل تهيئة متاحة لمفتاحك في استجابة واحدة. وهو كبير عن قصد ومخصص لمزامنة ليلية، لا لتحميل صفحة. اطّلع على نقطة النهاية.

نعم، يمكن تقييد نطاق المفاتيح، وGET /api/me يبلّغ عن أي قيود ضمن blocked_brands وyear_range. وهذا مفيد حين يغطّي عقد الوكالة جزءًا من السوق فقط.

تسع زوايا: ثماني زوايا خارجية (الأمام والخلف والجانبان والزوايا المائلة الأربع) إضافةً إلى لقطات داخلية مثل الكونسول الأوسط حيث توجد في المركبة. كل واحدة طلب مستقل على التهيئة نفسها، وبالتأطير الاستوديوي ذاته. اطّلع عليها جميعًا.

نعم، والتغيير يعيد طلاء لقطة الاستوديو الحقيقية، فيبقى اللون المعدني معدنيًا في المظهر. تتوفّر خمسة ألوان خاصة على كل مركبة، وفوقها ألوان فهرس كل علامة، إضافةً إلى أغلفة 3M. وGET /api/{...}/colors يعرض ما تتيحه سيارة بعينها. اطّلع على الألوان.

أربعة خيارات، كل منها وسيط واحد: shadow=true لظل استوديو مُسقَط، وground=true لظل تلامس يجعل السيارة تستقر على سطح، وmirroring=true لأرضية صالة عرض عاكسة، وtransparency=true لقصّ نظيف يمكنك وضعه على أي شيء. شاهد الفرق.

PNG وWebP وJPEG وAVIF، بعروض 200 أو 400 أو 800 أو 1200 أو 1600 أو 2000 بكسل، وبجودة بين 40 و100 (‏82 افتراضيًا). وتوجد أيضًا إعدادات مسمّاة من thumb ‏(320 بكسل) إلى full ‏(2000 بكسل) إن فضّلت عدم اختيار الأرقام.

أصلًا بنسبة 3:2. اطلب نسبة أخرى فتُملأ الصورة بدل أن تُقصّ، فلا يُقتطع شيء من السيارة أبدًا: 1:1 و4:3 و16:9 و16:10 و2:1 و21:9 ونظائرها الطولية كلها متاحة. ولهذا تستطيع بطاقة مربعة ولافتة عريضة استخدام المركبة نفسها دون مصمم بينهما.

نعم، transparency=true يعيد قصًّا بقناة ألفا حقيقية. وجدير بالمعرفة: الشفافية تفرض صيغة PNG، وملف PNG أثقل بأضعاف من السيارة نفسها بصيغة WebP. استخدمه حيث تحتاج قناة ألفا فعلًا، وWebP في ما عدا ذلك.

لا في الخطط العادية. GET /api/me يخبرك بدقة بما يسمح به مفتاحك، بما في ذلك ما إذا كانت العلامة المائية مفروضة.

هذا هو مغزى التصيير بدل الجمع. كل مركبة بموضع الكاميرا نفسه والمسافة نفسها والإضاءة نفسها، فيقارن الجدول المختلط سيارات لا مصوّرين. ولهذا ينتهي المطاف بفرق الأساطيل والتأجير التمويلي هنا.

إنه مسار: /api/{brand}/{model}/{year}/{variant}/{trim}/{view}. وطلب GET على أي بادئة أقصر يعرض المستوى التالي، فتُكتشف الشجرة كاملة بالسير فيها. لا مخطط يلزم تعلّمه قبل أول طلب.

نعم. رقم الهيكل يعمل في كل مكان؛ أما البحث باللوحة فيعتمد على السوق. والعلامة والطراز والسنة والفئة تُحدَّد أيضًا، وغالبًا لا يحمل نموذج الإعلان أو إقرار الأسطول أكثر من ذلك. المزيد عن التحديد.

لكل تهيئة معرّف دائم. GET /api/id/{id} يعيد كل الزوايا المتاحة، وGET /api/id/{id}/{view} يعيد واحدة. المعرّفات تصمد أمام تحديثات الفهرس وإعادة التسمية، فيمكن حفظها بأمان في قاعدة بياناتك.

نعم، ومعظم عمليات الربط تفعل ذلك. انسخ الصورة إلى تخزينك الخاص وقدّمها من هناك، حتى لا يعتمد تحميل صفحة على نداء إلينا. والروابط الموقّعة تبقى صالحة سبعة أيام، وهي مدة كافية للجلب والحفظ.

يرجع إلى أقرب قيمة صالحة ويخبرك بما فعله في errornotes بدل أن يفشل. هناك 17 رمزًا، لكل منها معنى بلغة واضحة، فيمكنك تسجيلها أو تجاهلها عن قصد. اطّلع على الرموز.

أقل بكثير مما يبدو عادةً. فالتهيئات المتطابقة تؤول إلى التصيير نفسه، وأربعون شاحنة صغيرة متطابقة خارجة من الخدمة هي صورة واحدة مُعاد استخدامها. خزّن مؤقتًا من طرفك، فتكلّف شاشة تعرض العشرين مركبة نفسها لكل زائر عشرين طلبًا إجمالًا، لا عشرين لكل زائر.

إنه عنوان HTTPS عادي، فيتعامل معه محمّل الصور لديك وذاكرته على القرص دون أي تغيير، في التطبيق الأصلي وفي عرض الويب سواء. اطلب العرض الذي يستخدمه التصميم فعلًا بدل تصغير صورة طباعية على الجهاز. مزيد لفرق التطبيقات.

لا، وعن قصد: الفهرس يُسحب ولا يُدفع. زامنه متى شئت عبر GET /api/getall، أو اقرأ سجل التغييرات لتعرف ما صدر. ولا يلزم أي نقطة نهاية من طرفك.

تُقدَّم من ذاكرة مؤقتة عالمية على الحافة، فيأتي أول بايت من موقع قريب من الزائر لا من خادم المصدر. وتُولَّد النسخة مرة واحدة ثم تُقدَّم من الذاكرة المؤقتة.

نعم. صفحة الحالة تعرض زمن التشغيل وأزمنة الاستجابة مباشرةً، مقيسة من خارج بنيتنا التحتية. وGET /api/status فحص جاهزية قابل للقراءة آليًا لاستخدامه في مراقبتك.

النسخ المخزّنة مؤقتًا لا تصل إلى الواجهة أصلًا، وهذا هو الوضع الطبيعي في صفحة فهرس يرى فيها كل زائر المركبات نفسها. ولهذا يتصرّف يوم الإطلاق أو يوم الحملة تمامًا كأي يوم ثلاثاء عادي.

لا شيء، إن اتبعت النمط المعتاد: انسخ الصورة مرة واحدة إلى تخزينك الخاص وقدّمها من هناك. عندئذ تعتمد صفحتك على شبكتك أنت لا على شبكتنا. وهذا أنفع ما يمكن بناؤه مبكرًا.

تُصيَّر من بيانات مركبات نملك ترخيصها. ليست صورًا فوتوغرافية ولم تُجمع من مواقع الوكلاء ولا من الحقائب الصحفية. ولهذا نستطيع تثبيت الاستخدامات المسموح بها كتابةً، وهو غالبًا السؤال الذي تبدأ به المحادثة مع الإدارة القانونية.

نعم. الإعلانات والتطبيقات والحملات والطباعة ومستندات العملاء كلها مشمولة، بلا سطر إسناد وبلا علامة مائية. أخبرنا بالمستندات التي تنتجها لتُدرج صراحةً في الترخيص.

نعم، ولدى شركات التأمين وجهات التمويل يكون هذا هو المقصود عادةً: عروض الأسعار وجداول الوثائق والعقود ومراسلات المطالبات. وللاطلاع على الطريقة المعتادة انظر التأمين والتمويل.

لا. لا يظهر أي شخص في الصورة ولا أي مكان محدد، وهذا يلغي فئة كاملة من إجراءات الحقوق التي يجرّها التصوير.

معرّفات المركبة فقط، لا غير. فرقم الهيكل يمكن إرساله دون الوثيقة أو الطلب أو العميل المرتبط به، ولا حاجة لأن يغادر أي شيء يخص شخصًا أنظمتك.

تُظهر الطراز والفئة ولون المصنع المسجّل، وهكذا استُخدمت صور الصانعين دائمًا. ليست صورة فوتوغرافية لوحدة بعينها ولا ينبغي وصفها كذلك. معظم المنصّات تعرضها بوصفها صورة تمثيلية لتلك التهيئة وتحتفظ بالصور الحقيقية للمعرض.

عرضها على مستخدميك مشمول تلقائيًا. أما السماح للمستخدمين بتنزيل الملفات أو إعادة توزيعها فحق مختلف، فأخبرنا إن كنت تحتاجه ليُدرَج في الترخيص صراحةً بدل أن يبقى ملتبسًا.

بحسب التهيئات المختلفة، لا بحسب مشاهدات الصفحة، ولذلك ينبسط منحنى التكلفة تمامًا حيث يتركّز الحجم: طراز تعرضه ألف مرة ليس ألف عملية تصيير. اطّلع على الخطط.

مزيج تقريبي من الطرازات، وعدد المركبات التي تعرضها أو تخدمها شهريًا. هذا يكفي. لدى شركة تأجير هو قائمة الفئات، ولدى جهة تمويل مزيج النسخ، ولدى بوابة عدد الإعلانات الشهري.

لا. الوسيط الذي يعدّ بضعة عروض أسبوعيًا والبوابة التي تدير ملايين الإعلانات يحصلان على الصور نفسها والخيارات نفسها.

GET /api/me يجيب عن ذلك في نداء واحد: الميزات المفعّلة، والصيغ المسموح بها، والدقات، والنسب، والزوايا، والألوان، والعلامات التجارية، إضافةً إلى أي قيود ومدة صلاحية الروابط الموقّعة. اطّلع على نقطة النهاية.

لا. تُصيَّر التهيئة مرة واحدة؛ وكل طلب لاحق للتركيبة نفسها يُقدَّم من الذاكرة المؤقتة. ولهذا فالبوابة التي تعرض الطراز نفسه ألف مرة لا تدفع ألف مرة.

راسلنا أو احجز مكالمة قصيرة. يصل الرد عادةً في يوم العمل نفسه، ويأتي ممن يبنون هذا المنتج، لا من طابور تذاكر.

أرسل لنا العلامة والطراز والسنة. إضافة طراز عمل معتاد بالنسبة إلينا لا خدمة استثنائية، وهي غالبًا أسرع طريقة لمعرفة ما إذا كان النقص مشكلة بيانات أم اختلافًا في التسمية.

اسأل. زاوية بعينها أو معالجة خلفية أو صيغة تسليم غير مدرجة، كل ذلك يستحق نقاشًا؛ فبعض ما صار اليوم قياسيًا بدأ بطلب من عميل واحد.