Açık artırma ilanları için araç görselleri

Bir müzayede kataloğu, konsinye araçlar gelir gelmez yayımlanır: her araç için bir VIN, bir lot numarası ve bir satış tarihi. Fotoğraflar ise araç sahaya, fotoğrafçı da araca ulaştığında gelir; bu da satışın bir kısmı için teklif verme açıldıktan sonra olur. O zamana kadar bu lotların her biri, bir satır metnin yanında duran gri bir kutudan ibarettir.

Bir katalog render'ı, kutuyu doğru model yılıyla doldurur. Ancak müzayede, bir render'ın asla aracın kendisi yerine geçmemesi gereken yerdir: teklif verenler aracın durumuna göre fiyat biçer ve render hiçbir durum bilgisi göstermez, çünkü belirli bir fiziksel aracı tasvir etmez. Aşağıdaki her şey, bu ikisini aynı anda göz önünde tutmaktan doğar.

• Her lot için VIN'inden bir render, yalnızca lotun kendi fotoğrafları gelene kadar gösterilir.
• Bir katalog seçici: VIN'i çözümlenemeyen lotlar için.
• Görselin üzerinde bir etiket: "Katalog render'ı, bu lot değil".
• Her lot için tek URL, bir kez oluşturulur; Idempotency-Key altında üretilir ve satış süresince geçerli kalır.

GET /api/v1/vin/{vin} ücretsizdir. Katalogda araç varsa yanıt, lota kaydedeceğiniz sabit kimlik olan data.vehicle.id değerini içerir; çözümlenen donanım, kasa ve motor bilgileri lotun metninde kalır. Katalog 1990 ile 2027 arasını kapsar, böylece bir müzayedenin eski stoku da en yenisi gibi render edilir. Sigorta kılavuzu bir çözümlemeyi alan alan anlatır; VIN belgeleri ise kısmi VIN'leri ve hataları ele alır.

Bazı lotlar çözümlenebilen bir VIN olmadan gelir: başka bir pazar için üretilmiş bir araç, kaynağın yanlış yazdığı bir VIN ya da yalnızca yıl, marka ve model içeren bir konsinye formu. Konsinye formuna, ücretsiz ve herkese açık olan GET /api/v1/vehicles ile beslenen üç açılır liste ekleyin: ?year= o yılda modeli bulunan markaları listeler, ?year=&makeId= ise o markanın modellerini, her birini o model yılının araç id'siyle birlikte listeler.

Aynı katalog, açık kaynaklı @meterapp/vehicle-db paketidir; bu nedenle açılır menüler aynı listeyle çevrimdışı da çalışabilir. Her iki durumda da lot, çözümlenmiş bir VIN ile aynı türde bir kimlik tutar ve sonraki hiçbir adımda araç adı elle yazılmaz.

Bütün bir konsinye listesi tek seferde geldiğinde, POST /api/v1/vehicles/check çağrı başına en fazla 2.000 kayıt okur; her kayıt listede yazıldığı şekliyle ve lot numarası ref olarak gönderilir. Her birine yanıt verir: saklanacak kimlikle bir eşleşme, öneriler, eşleşme yok ya da geçersiz satır. Hiçbir şey render edilmez ve ücret alınmaz; ayrıntılar araç belgelerinde yer alır.

Etiketi yalnızca alttaki açıklamaya değil, teklif verenin gözünün ilk düştüğü yere, yani görselin kendisine ve alt metne de koyun. Aracın durumu, kilometresi, hasarı, donanımları ve boyası lot metninde, fotoğraflar çekildikten sonra da fotoğraflarda yer almalıdır. Fotoğraflar geldiğinde render kaldırılır.

Lotun URL'sini kabul aşamasında POST /api/v1/image-urls ve satış ile lottan oluşturulan, harf, rakam, ., _, : ve - içeren bir Idempotency-Key ile oluşturun. URL, oluşturulduğu anda görselini o ayın araç görseli olarak sayar; bu nedenle anahtar olmadan yeniden denenen bir kabul işlemi ikinci bir URL oluşturur. Anahtarla:

• Aynı anahtar aynı gövdeyle 24 saat içinde tekrar gönderilirse ilk yanıt, aynı URL de dahil olmak üzere Idempotent-Replayed: true ile yeniden döndürülür ve ikinci kez ücret alınmaz.
• Aynı anahtar farklı bir gövdeyle gönderilirse 422, ilk isteği geride bırakan bir yeniden deneme ise Retry-After ile birlikte 409 döndürür. Bu yüzden lot oluşturulurken geçerlilik süresi dahil gövdedeki her şeyi sabitleyin ve lotla birlikte saklayın.
• URL'yi lota da kaydedin: anahtar yeniden denemeleri korur, sayfalar ise satışın geri kalanında bu kayıtlı URL'yi okur.

Tek seferde içe aktarılan bir kataloğun tamamı için, her toplu işte bir anahtar kullanılarak çağrı başına en fazla 50 lot için URL oluşturulabilir; yanıttaki her URL, oluşturulduğu aracı ve seçenekleri geri bildirir.

ttl_seconds en fazla 604800 (7 gün) olabilir; daha uzun bir değer bu sınıra indirilir. Hafta içinde kapanan bir satış için bunu kapanışa kalan süreye ayarlayın. Böylece yer tutucu görsel, teklif verme sona erdiğinde çalışmayı bırakır ve bundan sonra URL 403 döndürür.

• 7 günden uzun süren zamanlı bir satış: renew: true, en yüksek değerde ttl_seconds ve satışı kapsayan renew_days ile oluşturun. Bir yenileme, görseli denk geldiği ayda bir kez sayar ve görsel o ay zaten sayılmışsa başka bir şey sayılmaz; kimsenin lotu açmadığı haftalar hiçbir şey saymaz ve yenileme renews_until değerinde durur.
• max_uses değerini varsayılan olan 0’da bırakın. Sınırsız bir URL, geçerlilik süresi boyunca herkese açık olarak önbelleğe alınabilir. Sınırlı bir URL ise private, no-store olarak işaretlenir ve her yüklemeyi kaynak sunucuya gönderir.
• URL üreten anahtarı kısıtlayın: panelde yalnızca açık artırmanızın alan adlarına izin verin; başka bir siteye kopyalanan lot görseli 403 döndürür.

Her lot, aracının kendi boyası ve görünümüyle bir araç görselidir (iki lot bu üçünü de paylaşmıyorsa) ve her plan ayda belirli sayıda araç görseli içerir: Free 100, Pro 2.500 ve Business 10.000; Enterprise için sayı görüşülerek belirlenir. Bu ay zaten sayılmış bir görsel her zaman sunulur; kullanım hakkını aşacak bir toplu istek ise hiçbir şey sayılmadan bütünüyle reddedilir ve yanıtta plan ile kullanım hakkı belirtilir. Planı bir ayda listelediğiniz lot sayısına göre seçin. Pazar yeri hikâyesi, büyük bir içe aktarmanın hız ve render sınırları dahilinde nasıl yayılacağını anlatır.