Bayi yazılımında bir VIN'i veya stok listesini her araç için bir fotoğrafa dönüştürme

CRM, ERP veya bayi yönetim sistemindeki (DMS) bir stok kaydı hayatına bir VIN, bir stok numarası ve bir fiyat olarak başlar. Fotoğraf, galeri fotoğrafçısı geldiğinde gelir; bazı stoklar için ise hiç gelmez: yolda olan bir araç, hâlâ yenilenmekte olan bir takas aracı, model adı DMS'nin görsel akışındaki hiçbir şeyle eşleşmeyen bir ithal araç, kimsenin basın fotoğrafını lisanslamadığı 1990'lardan bir otomobil. Bu kaydı gösteren her ekran (satış temsilcisinin listesi, alıcının ekspertiz değerlendirmesi, müşterinin teklifi) bunun yerine gri bir yer tutucu gösterir.

API'yi kullanan bayi ve ithalat araçları bu yer tutucuyu kaydın zaten sahip olduğu bilgilerle doldurur. Kayıtta VIN varsa görsele ulaşmak için tek bir ücretsiz çözümleme yeterlidir. Yalnızca stok listesindeki bir satır varsa serbest metinle resolve işlemi sonuca ulaştırır. Her iki durumda da kayıt sabit bir araç kimliği tutar ve her ekran aynı aracı aynı şekilde render eder.

• Kayıt sırasında çözümleyin. VIN, kayıt oluşturulurken bir kez çözümlenir ve katalogdaki araç kimliği yanında saklanır. Sonraki hiçbir adımda marka veya model adı yazılmaz.
• Liste için bir görünüm, ayrıntı için bir görünüm. Envanter listeleri için geniş bir kutuda düz bir side; ayrıntı sayfası ve teklif için front-3-4.
• Geniş yıl aralığı. İthal ve ikinci el stok 1990'lara kadar uzanır ve yeni gelen araçlar gibi render edilir: katalog, Japon iç pazarına özgü modeller dahil, 1990 yılından güncel model yılına kadar uzanır.
• Uygulama içinde imzalı URL'ler. CRM bir tarayıcıda çalıştığından, sunucunun oluşturduğu anahtarsız imzalı URL'leri yükler: çağrı başına en fazla elli tane, bir haftadan uzun süre kalan kayıtlar için yenilenerek.

GET /api/v1/vin/{vin} ücretsizdir ve yalnızca bir API anahtarı gerektirir. Çözümlenmiş yıl, marka, model, donanım paketi, gövde sınıfı, motor ve NHTSA'nın vPIC verilerinin bildiği diğer tüm öznitelikleri; katalogda araç varsa da sabit kimliğini ve hazır bir image_path değerini içeren bir vehicle nesnesini döndürür. Kısmi VIN'ler de çalışır: En az beş karakter, bilinmeyen her konum için * ve isteğe bağlı bir year ipucu.

İthal stok çoğu zaman bir elektronik tablo olarak gelir: bir yıl, bir marka, açık artırma şirketinin kullandığı yazımla bir model adı, bir donanım veya paket kodu. POST /api/v1/images/resolve ücretsiz ve deterministiktir: ifadedeki yıl, renk ve görünüm sözcüklerini ayıklar, kalanıyla kataloğu arar ve üzerine işlem yapabileceğiniz bir güven puanıyla birlikte kesin parametreleri döndürür.

Araç doğru (2019 Toyota Voxy) ancak güven düzeyi low, çünkü "ZS" kataloğun tanımadığı bir donanım seviyesi ve eşleştirme bu bilgi atlanarak yapıldı. Toplu içe aktarmada high sonuçlarını tamamlanmış sayın; medium ve low sonuçlarını candidates listesiyle birlikte bir kişinin incelemesine sunun. Tabloda yıl ve marka zaten ayrı sütunlardaysa bunları year ve make alanları olarak gönderin ve query içinde yalnızca modeli bırakın; eşleşme çok daha temiz olur. Hiç araç kelimesi içermeyen bir ifade 400 döndürür; eşleşen modeli olmayan bir marka ise modeli sorabilmeniz için markanın yıllarını listeleyen bir 404 döndürür.

Hangi yoldan gelmiş olursanız olun, vehicle.id değerini (veya params.vehicle_id) stok kaydında düz bir metin sütunu olarak saklayın. Bu değer deterministik ve kalıcıdır: aynı araç her dağıtımda ve her katalog sürümünden sonra aynı kimliğe sahiptir, bu yüzden yabancı anahtar olarak güvenle kullanılabilir. Bundan sonra her görsel isteği vehicle=veh_… biçimindedir; bu yanlış yazılamaz ve üreticinin yeniden adlandırdığı ya da bir kaynağın farklı şekilde kaydettiği bir marka, saklanan bir URL'yi asla bozmaz.

Envanter listeleri geniş ve alçaktır; bu yüzden 2:1 oranlı bir kutuda düz yan görünüm genellikle tercih edilir: her araç aynı yöne bakar ve aynı taban çizgisinde durur. trim=1&padding=6 sığdırmadan önce görseli araca göre kırpar; böylece bir Hilux ile bir Yaris satırı aynı şekilde doldurur. fit=contain ise tuvali şeffaf kenar boşluklarıyla tam olarak 640×320 tutar. Ayrıntı sayfası 1024 boyutunda front-3-4 kullanır ve ikisi aynı önbelleği paylaşır: belirtmediğiniz bir boya rengi her ikisinde de gümüştür.

CRM tarayıcıda çalışır ve tarayıcı asla API anahtarını tutmamalıdır. Bir ekran stoktaki araçların bir sayfasını listelediğinde, sunucu POST /api/v1/image-urls ile her kayıt için bir imzalı URL oluşturur (çağrı başına en fazla elli; her URL'nin görseli ayın bir araç görseli olarak sayılır) ve sayfa bunları herhangi bir görsel gibi yükler. Aylarca stokta kalan bir kayıt için iki ayar önemlidir:

• ttl_seconds: 604800 ve renew: true: URL yedi günlük TTL'den sonra da çalışmaya devam eder; bir yenileme, görseli denk geldiği ayda bir kez sayar, o ay zaten sayılmışsa başka bir şey saymaz. Araca kimsenin bakmadığı aylarda hiçbir şey sayılmaz.
• Senkronizasyonun her sayfası için bir Idempotency-Key: yeniden denenen bir istek ilk yanıtı aynen döndürür ve hiçbir şeyi iki kez oluşturmaz.

Üreten anahtarı panelden CRM'in origin'iyle sınırlandırın; başka bir siteye sızan URL 403 yanıtı verir. Anahtarı iptal etmek, ürettiği tüm URL'leri geçersiz kılar. Planın o ayki araç görselleri tükenirse yenileme 402 yanıtı verir ve aynı URL, limit sıfırlandığında veya plan yükseltildiğinde yeniden çalışır. Tüm yaşam döngüsü imzalı URL belgelerinde yer alır.

• SDK: Yukarıdaki gibi client.decodeVin(vin, { year? }), client.resolve(query), client.getImage({ vehicle, … }) ve client.createImageUrls(…).
• MCP: decode_vin, resolve_vehicle, get_car_image ve create_car_image_urls temel araç setinde yer alır; böylece bağlamında stok sistemi bulunan bir asistan, kayıttaki VIN'den yola çıkarak "4471 numaralı stok için fotoğraf" isteğini yanıtlayabilir. Kurulum MCP sayfasında, çözücünün alanları ve hataları ise VIN belgelerinde yer alır.