Bilbilder for skadesaker og forsikringstilbud

Et tilbudsskjema, en polise og en første skademelding identifiserer alle kjøretøyet på samme måte: med VIN, skrevet inn av en kunde eller lest av et vognkort. Alt en person deretter ser om bilen, er tekst: et årstall, et merke, en modell og kanskje en utstyrsvariant. Å spørre «er dette kjøretøyet ditt?» ved siden av en tekstlinje inviterer til et ja til hva som helst.

Et bilde av modellen VIN-en dekodes til, lar kunden og skadebehandleren raskt sjekke at registreringen angir riktig type bil. Det kan ikke vise hvilken bil: en rendering er en studioillustrasjon av et merke, en modell og et år fra katalogen, og den avbilder ikke noe bestemt fysisk kjøretøy. Dette ene faktumet former hele integrasjonen nedenfor.

• Dekod ved mottak. Tilbudsflyten eller polisesystemet dekoder VIN-en én gang, gratis, og lagrer katalogens kjøretøy-ID sammen med polisen. Skadesaker som opprettes på polisen, arver den.
• Én visning overalt. front-3-4, hovedvinkelen, i én ramme i tilbudsskjermbildet, i skadebehandlingsverktøyet, i tilbuds-PDF-en og i forsikringsportalen, slik at alle skjermbilder viser modellen på samme måte.
• Signerte URL-er, aldri nøkkelen. Nettlesere og PDF-renderere laster nøkkelfrie URL-er som serveren deres oppretter.
• Ord for det et bilde ikke kan si. Utstyrsversjon, ekstrautstyr, registrert farge, skader og kilometerstand forblir tekst og fotografier, og bildet opplyses å være et illustrasjonsbilde.

GET /api/v1/vin/{vin} er gratis og krever en nøkkel med images:read. Den svarer med de dekodede feltene fra NHTSAs vPIC-data (årsmodell, merke, modell, utstyrsnivå, serie, karosseritype, motor og alle andre attributter vPIC kjenner til) og, når katalogen har kjøretøyet, et vehicle-objekt med en stabil id og en ferdig image_path.

Les trim: «Carrera, Carrera T, Carrera 4». Mønsteret til dette VIN-et dekker tre utstyrsversjoner, så selv dekodingen kan ikke si hvilken polisen forsikrer, og et bilde av 2024 911 kan det i hvert fall ikke. Be kunden bekrefte utstyrsversjonen, lagre den som tekst sammen med series og body_class, og la bildet vise modellen.

• En VIN med feil kontrollsiffer blir likevel dekodet, med valid: false og problemet i errors. suggested_vin markerer tegnet vPIC mener er feil, med !, og det er dette du bør vise personen som skriver.
• Et skjema som bare har de første tegnene, kan sende et delvis VIN: minst fem tegn, med * for hver ukjent posisjon og et valgfritt year.
• 404 betyr at vPIC ikke har noen oppføring for mønsteret. vPIC dekker kjøretøy laget for det amerikanske markedet, så for andre markeder bør du ta utgangspunkt i merke og modell med POST /api/v1/images/resolve, som også er gratis.

Lagre data.vehicle.id på polisen som en vanlig streng, og kopier den til hver skadesak som opprettes på den. ID-en er deterministisk og permanent: samme kjøretøy har samme ID ved hver utrulling og etter hver katalogversjon, så den er trygg å bruke som fremmednøkkel, og alle senere forespørsler oppgir vehicle=veh_78qtwrgh37bkr i stedet for å skrive ut merke og modell.

Når data.vehicle er null, finnes ikke det dekodede merket og modellen i katalogen, slik som med tilhengere og enkelte chassis for nyttekjøretøy. De dekodede feltene kan likevel vises. Vis dem uten bilde, og sett aldri inn en lignende bil i stedet.

Tilbudsskjermen, skadebehandlingsverktøyet og kundeportalen for forsikringer er nettleserapper, så serveren din genererer signerte URL-er med POST /api/v1/image-urls: hver URL teller bildet sitt som et av månedens kjøretøybilder når den genereres, opptil 50 per kall, og er gratis å laste inn til den utløper. Komponer bildet én gang og gjenbruk formen: front-3-4 i en 640×400-boks med fit: "contain", og trim med litt padding, slik at en coupé og en pickup fyller boksen på samme måte. Hvor lenge hver URL bør leve, avhenger av hvor den vises:

• Arbeidsflaten for skadesaker. Generer URL-en når skjermen tegnes. Standard levetid på 1 time dekker en arbeidsøkt, og en skadesak som gjenåpnes i morgen, får en ny URL.
• Tilbuds-PDF-en. Når PDF-en genereres fra HTML, laster PDF-motoren bildet én gang og bygger det inn, så standard levetid er mer enn nok, og PDF-tjenesten får aldri tilgang til nøkkelen din. format: "jpg" legger bildet på hvit bakgrunn, som er det et dokument trenger.
• Forsikringsportalen og fornyelses-e-posten. Disse varer lenger enn noen URL-levetid, så opprett med renew: true og ttl_seconds: 604800 (7 dager). URL-en fortsetter å virke. En fornyelse teller bildet én gang i måneden den skjer i, og ikke mer hvis det allerede er telt den måneden. renew_days: 365, det lengste som er tillatt, dekker en ettårig forsikringsperiode.

Gi nøkkelen som oppretter URL-ene, en liste over tillatte opprinnelser på dashbordet: en URL som lastes fra et annet nettsted, svarer 403 med origin_not_allowed, mens e-postklienter og PDF-visere, som ikke sender Referer, fortsatt laster den. Når nøkkelen tilbakekalles, slutter alle URL-er den har opprettet, å virke.

Plasser merkingen der bildet er, ikke bare i en fotnote: i alt-teksten og i en bildetekst under bildet. Renderingen viser merke, modell og årsmodell i en lakkfarge du velger, og color kan følge fargen på polisen (navnet på en forhåndsdefinert farge eller en hvilken som helst hex-kode). Det er likevel modellen i den fargen, ikke kundens bil.

• Gratis: VIN-dekoding, resolve, katalogoppslag og hver innlasting av en signert URL innenfor levetiden.
• Ett kjøretøybilde: hvert kjøretøy i hver lakkfarge og visning, telles én gang i måneden uansett hvor ofte det leveres, genereres eller fornyes, i alle størrelser og formater.
• Kjøretøybilder i måneden: En tilbudstrakt ser mange forskjellige kjøretøy, og hver plan inkluderer et visst antall av dem i måneden: Free 100, Pro 2 500 og Business 10 000. Enterprise forhandles. Et bilde som allerede er telt denne måneden, leveres alltid, og en forespørsel utover kvoten får svaret 402 før noe telles. Dimensjoner derfor planen etter kjøretøyene du gir tilbud på.

Med et betalt abonnement dekker lisensen en rendering i det produktet ditt lager for brukerne sine, for eksempel et tilbud eller en rapport, så lenge abonnementet er aktivt. Detaljene står i lisensen.

• SDK: client.decodeVin(vin, { year? }) og client.createImageUrls(…), som ovenfor; client.resolve(query) for et kjøretøy uten VIN.
• MCP: decode_vin og create_car_image_urls er med i kjerneverktøysettet, så en assistent med skadesaken i konteksten kan svare på «vis meg den forsikrede modellen» ut fra VIN-en som er registrert. Oppsettet står på MCP-siden.