Obrázky aut pro pojistné události a nabídky pojištění

Formulář nabídky, záznam pojistky i první oznámení škody označují vozidlo stejně: jeho VIN, které zadal zákazník nebo opsal z technického průkazu. Vše, co pak člověk o voze vidí, je text: rok, značka, model a případně výbava. Otázka „Je to vaše vozidlo?“ vedle řádku textu svádí k odpovědi ano na cokoli.

Obrázek modelu, na který se VIN dekóduje, umožní zákazníkovi i likvidátorovi na první pohled ověřit, že záznam uvádí správný druh auta. Nemůže ukázat, o které konkrétní auto jde: render je studiová ilustrace značky, modelu a roku z katalogu a nezobrazuje žádné konkrétní fyzické vozidlo. Tato jediná skutečnost určuje celou integraci popsanou níže.

• Dekódujte při příjmu. Proces kalkulace nebo systém pojistných smluv dekóduje VIN jednou, zdarma, a uloží ID vozidla z katalogu ke smlouvě. Pojistné události otevřené k této smlouvě ho převezmou.
• Jeden pohled všude. front-3-4, hlavní úhel, v jednom rámečku na obrazovce kalkulace, v pracovním prostředí likvidace pojistných událostí, v PDF nabídky i na portálu pojistných smluv, takže každá obrazovka zobrazuje model stejně.
• Podepsané URL, nikdy klíč. Prohlížeče a generátory PDF načítají URL bez klíče, které generuje váš server.
• Slova pro to, co obrázek neřekne. Výbava, příplatková výbava, evidovaná barva, poškození a nájezd zůstávají v textu a na fotkách a u obrázku je uvedeno, že je ilustrační.

GET /api/v1/vin/{vin} je zdarma a vyžaduje klíč s oprávněním images:read. Vrací dekódovaná pole z dat vPIC od NHTSA (rok, značka, model, výbava, série, typ karoserie, motor a všechny další atributy, které vPIC zná) a, pokud je vozidlo v katalogu, objekt vehicle s jeho stálým id a připravenou hodnotou image_path.

Přečtěte si trim: „Carrera, Carrera T, Carrera 4“. Vzor tohoto VIN pokrývá tři výbavy, takže ani dekódování neurčí, kterou z nich smlouva pojišťuje, a render modelu 911 z roku 2024 už vůbec ne. Požádejte zákazníka o potvrzení výbavy, uložte ji spolu se series a body_class jako text a obrázek nechte zobrazovat model.

• VIN se špatnou kontrolní číslicí se přesto dekóduje, s valid: false a popisem problému v errors; suggested_vin pomocí ! označí znak, který vPIC považuje za chybný, a právě to ukažte uživateli, který VIN zadává.
• Formulář, který má jen první znaky, může odeslat částečný VIN: alespoň pět znaků, s * za každou neznámou pozici a volitelným year.
• 404 znamená, že vPIC tento vzor nezná. vPIC pokrývá vozidla vyrobená pro americký trh, takže u ostatních trhů začněte od značky a modelu pomocí POST /api/v1/images/resolve, což je také zdarma.

Uložte data.vehicle.id k pojistce jako prostý řetězec a zkopírujte jej ke každé škodní události, která je k ní otevřena. Id je deterministické a trvalé: stejné vozidlo má stejné id při každém nasazení i po každém vydání katalogu, takže je bezpečné jako cizí klíč, a každý další požadavek uvádí vehicle=veh_78qtwrgh37bkr, místo aby vypisoval značku a model.

Když je data.vehicle null, dekódovaná značka a model v katalogu nejsou, jako u přívěsů a některých užitkových podvozků. Dekódovaná pole můžete i tak zobrazit. Zobrazte je bez obrázku a nikdy místo nich nedávejte podobné auto.

Obrazovka s nabídkou, pracoviště pro likvidaci pojistných událostí a portál pojistek jsou aplikace v prohlížeči, takže váš server generuje podepsané URL pomocí POST /api/v1/image-urls: každá URL započítá svůj obrázek jako obrázek vozidla daného měsíce v okamžiku vygenerování, až 50 na jedno volání, a až do vypršení platnosti se načítá zdarma. Obrázek jednou nakomponujte a tento tvar používejte opakovaně: front-3-4 v rámečku 640×400 s fit: "contain" a trim s trochou padding, aby kupé i pickup vyplnily rámeček stejně. Jak dlouho má každá URL platit, záleží na tom, kde se zobrazuje:

• Pracoviště pro likvidaci škod. URL vygenerujte při vykreslení obrazovky. Výchozí platnost v délce 1 hodiny pokryje pracovní relaci a škodní událost znovu otevřená zítra dostane nové URL.
• PDF nabídky. Když se PDF generuje z HTML, renderer obrázek jednou načte a vloží, takže výchozí doba platnosti bohatě stačí a služba pro PDF nikdy nemá váš klíč. format: "jpg" obrázek zploští na bílé pozadí, což je pro dokument přesně to pravé.
• Portál pojistek a e-mail o obnovení. Ty musí fungovat déle, než vydrží jakákoli platnost, takže URL vytvářejte s renew: true a ttl_seconds: 604800 (7 dní). URL zůstává funkční, obnovení započítá obrázek jednou v měsíci, ve kterém proběhne, a nic dalšího, pokud už byl v daném měsíci započítán, a renew_days: 365, nejdelší povolená hodnota, pokryje roční pojistné období.

Klíči, který generuje URL, nastavte na ovládacím panelu seznam povolených originů: URL načtená z jiného webu odpoví 403 s origin_not_allowed, zatímco e-mailoví klienti a prohlížeče PDF, které neposílají Referer, ji stále načtou. Zrušením klíče přestanou fungovat všechny URL, které vygeneroval.

Popisek umístěte tam, kde je obrázek, nejen do poznámky pod čarou: do alt textu a do titulku pod obrázkem. Render zobrazuje značku, model a rok v barvě, kterou zvolíte, a color může odpovídat barvě uvedené v pojistce (název předvolby nebo libovolný hex). Stále jde ale o model v této barvě, ne o vůz zákazníka.

• Zdarma: dekódování VIN, resolve, vyhledávání v katalogu a každé načtení podepsané URL během její platnosti.
• Jeden obrázek vozidla: každé vozidlo v každém laku a pohledu, započítané jednou měsíčně bez ohledu na to, jak často je doručeno, vygenerováno nebo obnoveno, v libovolné velikosti a formátu.
• Obrázky vozidel za měsíc: proces tvorby nabídek pracuje s mnoha různými vozidly a každý tarif jich měsíčně zahrnuje určitý počet: Free 100, Pro 2 500 a Business 10 000; Enterprise je podle dohody. Obrázek již v tomto měsíci započítaný se zobrazí vždy a požadavek nad rámec limitu vrátí 402 dřív, než se cokoli započítá, proto tarif zvolte podle počtu vozidel, pro která připravujete nabídky.

U placeného tarifu licence pokrývá render v rámci toho, co váš produkt vytváří pro své uživatele, včetně nabídky nebo zprávy, a to po celou dobu, kdy je tarif aktivní; podrobnosti najdete v licenci.

• SDK: client.decodeVin(vin, { year? }) a client.createImageUrls(…) jako výše; client.resolve(query) pro vozidlo bez VIN.
• MCP: decode_vin a create_car_image_urls jsou součástí základní sady nástrojů, takže asistent, který má pojistnou událost v kontextu, dokáže na pokyn „ukaž mi pojištěný model“ odpovědět podle VIN uloženého ve spisu. Nastavení najdete na stránce MCP.