Imagini auto pentru daune și oferte de asigurare

Un formular de ofertă, o înregistrare de poliță și o primă notificare de daună identifică toate vehiculul în același fel: prin VIN, tastat de un client sau citit de pe certificatul de înmatriculare. Tot ce vede apoi o persoană despre mașină este text: un an, o marcă, un model și poate o versiune de echipare. Să întrebați „Acesta este vehiculul dumneavoastră?” lângă un rând de text invită la un „da” pentru orice.

O imagine a modelului în care se decodează VIN-ul le permite clientului și inspectorului de daune să verifice dintr-o privire că înregistrarea indică tipul corect de mașină. Nu poate arăta care mașină anume: o randare este o ilustrație de studio a unei mărci, a unui model și a unui an din catalog și nu înfățișează niciun vehicul fizic anume. Acest singur fapt determină întreaga integrare de mai jos.

• Decodare la preluare. Fluxul de cotație sau sistemul de polițe decodează VIN-ul o singură dată, gratuit, și stochează id-ul de vehicul din catalog împreună cu polița. Daunele deschise pe poliță îl moștenesc.
• O singură vedere peste tot. front-3-4, unghiul principal, într-un singur chenar pe ecranul de ofertă, în aplicația de gestionare a daunelor, în PDF-ul ofertei și în portalul poliței, astfel încât fiecare ecran să arate modelul la fel.
• URL-uri semnate, niciodată cheia. Browserele și generatoarele de PDF încarcă URL-uri fără cheie, generate de serverul dumneavoastră.
• Cuvinte pentru ceea ce o imagine nu poate spune. Versiunea de echipare, opțiunile, culoarea din evidențe, daunele și kilometrajul rămân în text și fotografii, iar imaginea menționează că este reprezentativă.

GET /api/v1/vin/{vin} nu costă nimic și necesită o cheie cu images:read. Răspunde cu câmpurile decodate din datele vPIC ale NHTSA (an, marcă, model, versiune de echipare, serie, tip de caroserie, motor și orice alt atribut cunoscut de vPIC) și, când catalogul conține vehiculul, cu un obiect vehicle care include id-ul său stabil și un image_path gata de folosit.

Citiți trim: „Carrera, Carrera T, Carrera 4”. Modelul acestui VIN acoperă trei versiuni de echipare, deci nici decodarea nu poate spune pe care o asigură polița, iar o randare a lui 911 din 2024 cu atât mai puțin. Cereți clientului să confirme versiunea, păstrați-o ca text alături de series și body_class și lăsați imaginea să arate modelul.

• Un VIN cu cifra de control greșită se decodează totuși, cu valid: false și problema în errors; suggested_vin marchează cu ! caracterul pe care vPIC îl consideră greșit, iar asta trebuie să îi arătați persoanei care îl introduce.
• Un formular care are doar primele caractere poate trimite un VIN parțial: cel puțin cinci caractere, cu * pentru fiecare poziție necunoscută și un year opțional.
• Un 404 înseamnă că vPIC nu are nicio înregistrare pentru acest tipar. vPIC acoperă vehiculele fabricate pentru piața din SUA, așa că pentru alte piețe porniți de la marcă și model cu POST /api/v1/images/resolve, care este de asemenea gratuit.

Stocați data.vehicle.id în poliță ca șir simplu și copiați-l în fiecare dosar de daună deschis pe baza ei. Id-ul este determinist și permanent: același vehicul are același id la fiecare implementare și după fiecare versiune a catalogului, deci poate fi folosit în siguranță drept cheie străină, iar fiecare cerere ulterioară specifică vehicle=veh_78qtwrgh37bkr în loc să precizeze o marcă și un model.

Când data.vehicle este null, marca și modelul decodate nu se află în catalog, cum este cazul remorcilor și al unor șasiuri comerciale. Câmpurile decodate pot fi totuși afișate. Afișați-le fără imagine și nu puneți niciodată o mașină similară în locul vehiculului.

Ecranul de ofertare, consola de gestionare a daunelor și portalul de polițe sunt aplicații de browser, așa că serverul dumneavoastră generează URL-uri semnate cu POST /api/v1/image-urls: fiecare URL contorizează imaginea ca imagine de vehicul a lunii în momentul generării, până la 50 per apel, și poate fi încărcat gratuit până la expirare. Încadrați imaginea o singură dată și refolosiți formatul: front-3-4 într-un cadru de 640×400 cu fit: "contain" și trim cu puțin padding, astfel încât un coupé și un pickup să umple cadrul la fel. Cât timp trebuie să rămână valabil fiecare URL depinde de locul în care este afișat:

• Platforma de lucru pentru daune. Generați URL-ul când se afișează ecranul. Durata de valabilitate implicită de 1 oră acoperă o sesiune de lucru, iar un dosar de daună redeschis mâine primește un URL nou.
• PDF-ul ofertei. Când PDF-ul este generat din HTML, motorul de randare încarcă imaginea o singură dată și o încorporează, așa că durata de valabilitate implicită este suficientă, iar serviciul PDF nu deține niciodată cheia dumneavoastră. format: "jpg" aplatizează imaginea pe fundal alb, exact ce îi trebuie unui document.
• Portalul poliței și e-mailul de reînnoire. Acestea durează mai mult decât orice TTL, așa că generați URL-urile cu renew: true și ttl_seconds: 604800 (7 zile). URL-ul continuă să funcționeze, o reînnoire contorizează imaginea o dată în luna în care are loc și nimic în plus dacă a fost deja contorizată în acea lună, iar renew_days: 365, valoarea maximă permisă, acoperă o poliță cu durata de un an.

Setați pentru cheia care generează URL-urile o listă de origini permise în panoul de control: un URL încărcat de pe alt site răspunde cu 403 și origin_not_allowed, în timp ce clienții de e-mail și vizualizatoarele PDF, care nu trimit Referer, îl încarcă în continuare. Revocarea cheii invalidează toate URL-urile generate de ea.

Puneți eticheta acolo unde este imaginea, nu doar într-o notă de subsol: în textul alternativ și într-o legendă sub imagine. Randarea arată marca, modelul și anul într-o culoare aleasă de dumneavoastră, iar color poate urma culoarea din poliță (numele unei culori predefinite sau orice cod hex). Rămâne totuși modelul în acea culoare, nu mașina clientului.

• Gratuit: decodarea VIN, rezolvarea, căutările în catalog și fiecare încărcare a unui URL semnat pe durata sa de valabilitate.
• O imagine de vehicul: fiecare vehicul în fiecare culoare și vedere, contorizat o singură dată pe lună, indiferent de câte ori este livrat, generat sau reînnoit, la orice dimensiune și în orice format.
• Imagini de vehicul pe lună: un flux de oferte vede multe vehicule diferite, iar fiecare plan include un anumit număr pe lună: Free 100, Pro 2.500 și Business 10.000; pentru Enterprise se negociază. O imagine deja numărată luna aceasta este servită întotdeauna, iar o cerere peste limită primește răspunsul 402 înainte să se numere ceva, așa că alegeți planul în funcție de vehiculele pentru care emiteți oferte.

Pe un plan plătit, licența acoperă o randare inclusă în ceea ce produsul dumneavoastră generează pentru utilizatorii săi, inclusiv o ofertă sau un raport, atâta timp cât planul este activ; detaliile se află în licență.

• SDK: client.decodeVin(vin, { year? }) și client.createImageUrls(…), ca mai sus; client.resolve(query) pentru un vehicul fără VIN.
• MCP: decode_vin și create_car_image_urls fac parte din setul de instrumente de bază, astfel încât un asistent care are dosarul de daună în context poate răspunde la „arată-mi modelul asigurat” pe baza VIN-ului din dosar. Configurarea este descrisă pe pagina MCP.