إذا كان مخزونك في نظام DMS أو موقع معرض أو منصة إعلانات، فلا ينبغي لمن يلتقطون الصور أن يرفعوها مرتين. وLotShow API مبنية لهذا الغرض تحديدًا: يرسل موجزك صورة من الساحة، ويعيد LotShow صورة استوديو.
الحصول على مفتاح
مفاتيح API متاحة في باقتَي «احترافي» و«النخبة». أنشئ مفتاحًا من الإعدادات، ضمن مفاتيح API، واحفظه على خادمك: لا يظهر إلا مرة واحدة. كل نقاط النهاية والبيانات موجودة في صفحة API.
شكل التكامل مع الموجز
أيًّا كان النظام لديك، فالدورة واحدة:
- تصل إلى موجزك سيارة جديدة، أو صورة جديدة لسيارة لديك بالفعل.
- يرسل نظامك هذه الصورة إلى
POST /v1/jobs، مع صالة العرض التي تريدها ورابط webhook لديك. - يضع LotShow المهمة في قائمة الانتظار ويخصم لها نقطة واحدة.
- حين تجهز الصورة، يتصل LotShow بـ webhook لديك ومعه رابط الصورة الجاهزة.
- يحفظ نظامك الصورة مع بيانات السيارة وينشرها.
لا شيء في هذه الدورة يحتاج إلى تدخل شخص، وهذا هو المقصود. يواصل العاملون في الساحة التصوير، وتصل الصور إلى حيث يراها المشترون.
صورة واحدة تدخل، وصورة استوديو واحدة تخرج
تأخذ المهمة صورة واحدة وصالة عرض واحدة. ويبدو الطلب هكذا:
curl https://api.lotshow.com/v1/jobs \
-H "Authorization: Bearer $LOTSHOW_KEY" \
-F image=@stock-4471-front.jpg \
-F backdrop=white-hall \
-F vehicle=stock-4471 \
-F webhook=https://yourdms.com/hooks/lotshowتعود الاستجابة فورًا مع معرّف المهمة والحالة queued. احتفظ بسجل خاص بك يربط كل معرّف مهمة برقم المخزون وموضع الصورة. وحين يصل webhook، يخبرك هذا السجل بالضبط أين توضع الصورة. كما يجمع اسم vehicle صور السيارة في سيارة واحدة ضمن المخزون في LotShow.
حدّد الصور التي ترسلها
ليست كل صورة بحاجة إلى خلفية. قاعدة أولى جيدة: أرسل اللقطات الخارجية، حيث يهم المشهد خلف السيارة أكثر، وانشر لقطات المقصورة والتفاصيل كما هي. هكذا يبقى المظهر متسقًا وعدد النقاط متوقعًا: ثماني لقطات خارجية للسيارة تعني ثماني نقاط.
اختر صالة عرض موحّدة واحدة للموجز كله ومرّرها مع كل مهمة. وإذا كانت السيارات المميزة تحتاج إلى مظهر مختلف، فاجعل ذلك حقلًا في نظامك بدلًا من خيار يتخذه شخص يدويًا. يشرح دليلنا عن اختيار أسلوب معرضك كيفية الاختيار.
تنظيم الإيقاع
كل مهمة صورة واحدة، فالسيارة ذات اللقطات الخارجية الثماني تعني ثمانية طلبات، ويستطيع كل مفتاح إرسال 120 طلبًا في الدقيقة. إذا وصلتك أربعون سيارة يوم الاثنين، فأرسلها بإيقاع ثابت بدلًا من موجة واحدة ضخمة، ودع webhooks تخبرك بانتهاء كل منها. كل مهمة تعمل مستقلة، فلا تستطيع صورة سيئة واحدة أن تعطّل البقية.
حين تفشل مهمة
أحيانًا يتعذّر إنهاء صورة: السيارة مقطوعة عند حافة الإطار، أو الصورة مظلمة جدًا، أو الملف تالف. حينها يصلك حدث job.failed بدلًا من job.completed، وتعود النقطة مباشرة إلى رصيدك. اجعل نظامك يضع علامة على السيارة لإعادة تصويرها بدلًا من إرسال الصورة نفسها مرارًا في حلقة مفرغة.
النقاط تعمل بالطريقة نفسها في كل مكان
تسحب واجهة API من الرصيد نفسه الذي يستخدمه استوديو الويب: نقطة واحدة لكل صورة جاهزة، تُسترد تلقائيًا إذا فشلت الصورة. ولا تحتاج حزم الشحن من 50 نقطة مقابل $6.99 أو 250 نقطة مقابل $29.99 إلى اشتراك.
الاستعداد
يجري معظم العمل من جهتك. حدّد أين تدخل الصور الجديدة إلى نظامك، وقرّر أي الصور تحتاج إلى خلفية، وأضف حقلًا لمعرّف المهمة، وجهّز نقطة نهاية HTTPS تستقبل webhook. يشرح مقالنا Webhooks 101 هذا الجزء الأخير. ثم أنشئ مفتاحًا من الإعدادات وأرسل صورتك الأولى.