Stok akışınızı LotShow API'ye göndermek

Stoğunuz bir DMS'te, bir bayi web sitesinde veya bir pazar yerinde duruyorsa, fotoğrafları çekenlerin onları iki kez yüklemesi gerekmemeli. LotShow API tam da bunun için yapıldı: akışınız bir saha fotoğrafı gönderir, LotShow bir stüdyo fotoğrafı geri gönderir.

Anahtar almak

API anahtarları Pro ve Elit ile gelir. Ayarlar'da, API anahtarları bölümünden bir anahtar oluşturun ve onu sunucunuzda saklayın: yalnızca bir kez gösterilir. Tüm uç noktalar ve veri yapıları API sayfasında.

Bir akış entegrasyonunun yapısı

Sizin tarafınızda hangi sistem olursa olsun döngü aynıdır:

1. Akışınıza yeni bir araç ya da elinizdeki bir aracın yeni bir fotoğrafı düşer.
2. Sisteminiz bu fotoğrafı, istediğiniz showroom ve webhook'unuzun URL'siyle birlikte POST /v1/jobs adresine gönderir.
3. LotShow işi sıraya alır ve bunun için bakiyenizden bir kredi düşer.
4. Fotoğraf bittiğinde LotShow, bitmiş görselin URL'siyle webhook'unuzu çağırır.
5. Sisteminiz görseli araçla eşleştirerek kaydeder ve yayınlar.

Bu döngünün hiçbir adımı bir insana ihtiyaç duymaz; asıl amaç da bu. Sahadakiler çekmeye devam eder, fotoğraflar alıcıların gördüğü yere ulaşır.

Bir fotoğraf girer, bir stüdyo fotoğrafı çıkar

Bir iş tek bir görsel ve tek bir showroom alır. Bir istek şöyle görünür:

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

Yanıt hemen, bir iş kimliği ve queued durumuyla döner. Hangi iş kimliğinin hangi stok numarasına ve hangi fotoğraf sırasına ait olduğunu kendi kayıtlarınızda tutun. Webhook geldiğinde bu kayıt, görselin tam olarak nereye gideceğini söyler. vehicle adı ayrıca bir aracın fotoğraflarını LotShow'daki Envanter sayfanızda tek bir araç altında toplar.

Hangi fotoğrafları göndereceğinize karar verin

Her fotoğrafın bir fona ihtiyacı yoktur. İyi bir başlangıç kuralı, aracın arkasındaki sahnenin en çok önem taşıdığı dış çekimleri göndermek, iç mekân ve ayrıntı karelerini olduğu gibi yayınlamaktır. Böylece görünüm tutarlı, kredi sayısı da öngörülebilir kalır: araç başına sekiz dış çekim, sekiz kredi demektir.

Tüm akış için tek bir kurumsal showroom seçin ve bunu her işte gönderin. Öne çıkan araçların farklı görünmesi gerekiyorsa, bunu birinin elle verdiği bir karar yerine kendi sisteminizde bir alan hâline getirin. Kurumsal stil seçme rehberimiz nasıl seçeceğinizi anlatıyor.

Gönderim hızı

Her iş tek bir fotoğraftır; yani sekiz dış çekimi olan bir araç sekiz istek demektir ve her anahtar dakikada 120 istek yapabilir. Pazartesi günü bir sevkiyat kırk araç getirirse, onları tek seferde dev bir yük hâlinde değil, düzenli bir hızla gönderin ve her birinin ne zaman bittiğini webhook'lar size söylesin. Her iş bağımsız çalışır, bu yüzden kötü bir fotoğraf diğerlerini bekletemez.

Bir iş başarısız olduğunda

Bazen bir fotoğraf tamamlanamaz: araç karenin kenarında kesilmiştir, görsel çok karanlıktır ya da dosya bozuktur. Bu durumda job.completed yerine bir job.failed olayı alırsınız ve kredi doğrudan bakiyenize döner. Aynı görseli bir döngü içinde tekrar tekrar göndermek yerine, sisteminizin aracı yeniden çekim için işaretlemesini sağlayın.

Hazırlık

İşin büyük kısmı sizin tarafınızda. Yeni fotoğrafların sisteminize nereden girdiğini bulun, hangi fotoğrafların fon alacağına karar verin, iş kimliği için bir alan ekleyin ve webhook alabilecek bir HTTPS uç noktası kurun. Son adımı Webhook'lara giriş yazımız anlatıyor. Ardından Ayarlar'da bir anahtar oluşturun ve ilk fotoğrafınızı gönderin.