Sigorta hasar dosyaları ve teklifleri için araç görselleri

Bir teklif formu, bir poliçe kaydı ve bir ilk hasar ihbarı aracı aynı şekilde tanımlar: müşterinin yazdığı ya da ruhsattan okunan VIN ile. Ardından bir kişinin araç hakkında gördüğü her şey metindir: bir yıl, bir marka, bir model ve belki bir donanım paketi. Bir satır metnin yanında "Bu sizin aracınız mı?" diye sormak, her şeye evet denmesine davetiye çıkarır.

VIN'in çözümlendiği modelin bir resmi, müşterinin ve eksperin kaydın doğru türde bir aracı belirttiğini bir bakışta kontrol etmesini sağlar. Ancak hangi araç olduğunu gösteremez: render, katalogdaki bir marka, model ve yılın stüdyo illüstrasyonudur ve belirli bir fiziksel aracı tasvir etmez. Aşağıdaki entegrasyonun tamamı bu tek gerçeğe göre şekillenir.

• Kayıt sırasında çözümleyin. Teklif akışı veya poliçe sistemi VIN'i bir kez ve ücretsiz olarak çözümler, kataloğun araç kimliğini poliçeyle birlikte saklar. Poliçeye bağlı açılan hasar dosyaları bu kimliği devralır.
• Her yerde tek görünüm. Ana açı olan front-3-4; teklif ekranında, hasar çalışma alanında, teklif PDF'inde ve poliçe portalında tek bir kutu içinde; böylece her ekran modeli aynı şekilde gösterir.
• Anahtar değil, her zaman imzalı URL'ler. Tarayıcılar ve PDF oluşturucular, sunucunuzun ürettiği anahtarsız URL'leri yükler.
• Görselin söyleyemediği şeyler için sözcükler. Donanım, opsiyonlar, kayıtlı renk, hasar ve kilometre metin ve fotoğraf olarak kalır; görsel ise temsili olduğunu belirtir.

GET /api/v1/vin/{vin} ücretsizdir ve images:read yetkisine sahip bir anahtar gerektirir. NHTSA'nın vPIC verilerinden çözümlenen alanlarla (yıl, marka, model, donanım, seri, gövde tipi, motor ve vPIC'in bildiği diğer tüm özellikler) ve araç katalogda varsa, kalıcı kimliğini ve kullanıma hazır bir image_path değerini içeren bir vehicle nesnesiyle yanıt verir.

trim alanını okuyun: "Carrera, Carrera T, Carrera 4". Bu VIN'in deseni üç donanım seviyesini kapsar; dolayısıyla çözümleme bile poliçenin hangisini sigortaladığını söyleyemez, 2024 911 görseli ise hiç söyleyemez. Müşteriden donanım seviyesini onaylamasını isteyin, bunu series ve body_class ile birlikte metin olarak saklayın ve görselin modeli göstermesine izin verin.

• Kontrol hanesi hatalı bir VIN yine de çözümlenir; valid: false döner ve sorun errors içinde yer alır. suggested_vin, vPIC'in hatalı olduğunu düşündüğü karakteri ! ile işaretler; yazan kişiye gösterilmesi gereken de budur.
• Yalnızca ilk karakterleri bulunan bir form kısmi VIN gönderebilir: en az beş karakter, bilinmeyen her konum için * ve isteğe bağlı bir year.
• 404, vPIC'te bu kalıba ait kayıt olmadığı anlamına gelir. vPIC, ABD pazarı için üretilmiş araçları kapsar; diğer pazarlar için marka ve modelden POST /api/v1/images/resolve ile başlayın, bu da ücretsizdir.

data.vehicle.id değerini poliçede düz bir dize olarak saklayın ve bu poliçeye karşı açılan her hasar dosyasına kopyalayın. Kimlik 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 ve sonraki her istek marka ve modeli yazmak yerine vehicle=veh_78qtwrgh37bkr belirtir.

data.vehicle null olduğunda, römorklarda ve bazı ticari şasilerde olduğu gibi, çözümlenen marka ve model katalogda yoktur. Çözümlenen alanları yine de gösterebilirsiniz. Bunları görselsiz gösterin ve asla yerine benzer bir araç koymayın.

Teklif ekranı, hasar çalışma alanı ve poliçe portalı tarayıcı uygulamalarıdır; bu nedenle sunucunuz imzalı URL'leri POST /api/v1/image-urls ile üretir: her URL, üretildiği anda görselini ayın araç görseli olarak sayar, çağrı başına en fazla 50 URL üretilebilir ve süresi dolana kadar yüklemek ücretsizdir. Görseli bir kez çerçeveleyin ve aynı şekli yeniden kullanın: 640×400 kutuda fit: "contain" ile front-3-4 ve bir coupe ile bir pikabın kutuyu aynı şekilde doldurması için biraz padding ile trim. Her URL'nin ne kadar süre geçerli olacağı, nerede gösterildiğine bağlıdır:

• Hasar iş ekranı. URL'yi ekran çizildiğinde oluşturun. 1 saatlik varsayılan geçerlilik süresi bir çalışma oturumunu kapsar; yarın yeniden açılan bir hasar dosyası yeni bir URL alır.
• Teklif PDF'i. PDF HTML'den oluşturulduğunda, oluşturucu görseli bir kez yükleyip gömer; bu nedenle varsayılan geçerlilik süresi fazlasıyla yeterlidir ve PDF hizmeti anahtarınızı hiçbir zaman tutmaz. format: "jpg" görseli beyaz zemin üzerine düzleştirir; bir belge için istenen de budur.
• Poliçe portalı ve yenileme e-postası. Bunlar herhangi bir geçerlilik süresinden daha uzun süre kullanılır; bu yüzden renew: true ve ttl_seconds: 604800 (7 gün) ile oluşturun. URL çalışmaya devam eder; bir yenileme, görseli denk geldiği ayda bir kez sayar, o ay zaten sayılmışsa hiçbir şey eklemez; izin verilen en uzun değer olan renew_days: 365 ise bir yıllık poliçe dönemini kapsar.

URL'leri üreten anahtara panelde izin verilen kaynakların (origin) bir listesini tanımlayın: başka bir siteden yüklenen URL 403 ve origin_not_allowed ile yanıt verir; Referer göndermeyen e-posta istemcileri ve PDF görüntüleyiciler ise onu yüklemeye devam eder. Anahtarı iptal etmek, ürettiği tüm URL'leri geçersiz kılar.

Etiketi yalnızca bir dipnota değil, görselin bulunduğu yere koyun: alt metne ve görselin altındaki açıklamaya. Render, seçtiğiniz bir boya renginde marka, model ve yılı gösterir; color poliçedeki rengi izleyebilir (hazır bir renk adı veya herhangi bir hex kodu). Yine de bu, müşterinin aracı değil, o renkteki modeldir.

• Ücretsiz: VIN çözümleme, resolve, katalog sorguları ve imzalı bir URL'nin geçerlilik süresi içindeki her yüklenmesi.
• Tek araç görseli: her boya ve görünümdeki her araç, herhangi bir boyut ve formatta ne sıklıkla teslim edilirse, üretilirse veya yenilenirse yenilensin ayda bir kez sayılır.
• Aylık araç görselleri: bir teklif hunisi birçok farklı araç görür ve her plan ayda belirli sayıda araç görseli içerir: Ücretsiz 100, Pro 2.500 ve Business 10.000; Enterprise için pazarlık yapılır. Bu ay zaten sayılmış bir görsel her zaman sunulur ve kotayı aşan bir istek, hiçbir şey sayılmadan önce 402 ile yanıtlanır; bu yüzden planı teklif verdiğiniz araçlara göre seçin.

Ücretli bir planda lisans, plan aktif olduğu sürece ürününüzün kullanıcıları için ürettiği içeriklerdeki (teklif veya rapor dahil) bir render'ı kapsar; ayrıntılar lisansta yer alır.

• SDK: yukarıdaki gibi client.decodeVin(vin, { year? }) ve client.createImageUrls(…); VIN'i olmayan bir araç için client.resolve(query).
• MCP: decode_vin ve create_car_image_urls çekirdek araç setinde yer alır; böylece bağlamında hasar dosyası bulunan bir asistan, kayıtlı VIN'den yola çıkarak "sigortalı modeli göster" isteğini yanıtlayabilir. Kurulum MCP sayfasında anlatılır.