Cum transformați un VIN sau o listă de stoc într-o fotografie pentru fiecare vehicul din software-ul pentru dealeri

O înregistrare de stoc într-un CRM, un ERP sau un sistem de gestiune pentru dealeri (DMS) începe ca un VIN, un număr de stoc și un preț. Fotografia vine când vine fotograful din parcare, iar pentru unele mașini nu vine niciodată: o unitate în tranzit, o mașină preluată în schimb aflată încă în recondiționare, un import al cărui nume de model nu corespunde cu nimic din fluxul de imagini al DMS-ului, o mașină din anii 1990 pentru care nimeni nu a licențiat o fotografie de presă. Fiecare ecran care afișează acea înregistrare – lista vânzătorului, evaluarea cumpărătorului, oferta pentru client – arată în schimb un substituent gri.

Instrumentele pentru dealeri și de import care folosesc API-ul completează acel substituent din ce conține deja înregistrarea. Dacă are un VIN, imaginea se află la o singură decodare gratuită distanță. Dacă are doar un rând într-o listă de stoc, rezolvarea din text liber ajunge acolo. În ambele cazuri, înregistrarea ajunge să conțină un id de vehicul stabil, iar fiecare ecran randează aceeași mașină în același mod.

• Decodare la preluare. VIN-ul este decodat o singură dată, la crearea înregistrării, iar id-ul vehiculului din catalog este stocat lângă el. Nimic din aval nu mai scrie marca sau modelul.
• O vedere pentru listă, una pentru detalii. Un side drept, într-un cadru lat, pentru listele de stoc; front-3-4 pentru pagina de detalii și oferta de preț.
• Ani îndepărtați. Stocul de import și cel rulat ajung până în anii 1990 și se randează la fel ca noutățile: catalogul acoperă perioada din 1990 până la anul-model curent, inclusiv modelele pentru piața internă japoneză.
• URL-uri semnate în aplicație. CRM-ul rulează în browser, așa că încarcă URL-uri semnate fără cheie, generate de server, până la cincizeci per apel, reînnoite pentru înregistrările care rămân active mai mult de o săptămână.

GET /api/v1/vin/{vin} nu costă nimic și necesită doar o cheie API. Returnează anul, marca, modelul, versiunea de echipare, tipul de caroserie, motorul decodate și orice alt atribut cunoscut de datele vPIC ale NHTSA, iar, atunci când catalogul conține vehiculul, un obiect vehicle cu id-ul său stabil și un image_path gata pregătit. Funcționează și VIN-urile parțiale: cel puțin cinci caractere, * pentru fiecare poziție necunoscută, plus un indiciu opțional year.

Stocul de import vine adesea sub formă de foaie de calcul: un an, o marcă, un nume de model scris în ce variantă a folosit casa de licitații, un cod de grad sau de echipare. POST /api/v1/images/resolve este gratuit și determinist: extrage din expresie cuvintele pentru an, culoare și vedere, caută în catalog cu ce rămâne și returnează parametri exacți, împreună cu un nivel de încredere pe baza căruia puteți acționa.

Vehiculul este corect (Toyota Voxy 2019), dar nivelul de încredere este low, deoarece „ZS” este o versiune pe care catalogul nu o cunoaște, iar potrivirea a trebuit să o ocolească. Într-un import în lot, considerați high drept rezolvat și trimiteți medium și low spre verificare umană, împreună cu lista candidates. Când foaia are deja anul și marca în coloane separate, trimiteți-le în câmpurile year și make și lăsați doar modelul în query; potrivirea devine mult mai precisă. O frază fără cuvinte despre vehicule returnează 400, iar o marcă fără model corespunzător returnează 404, cu anii disponibili pentru marca respectivă, ca să puteți cere modelul.

Indiferent de calea prin care ați ajuns aici, stocați vehicle.id (sau params.vehicle_id) în înregistrarea de stoc, ca o coloană simplă de tip string. Este determinist și permanent: același vehicul are același id la fiecare implementare și după fiecare lansare a catalogului, deci poate fi folosit în siguranță ca cheie străină. De atunci încolo, fiecare cerere de imagine este vehicle=veh_…, care nu poate fi scris greșit, iar o marcă redenumită de un producător sau reclasificată de o sursă nu va strica niciodată un URL stocat.

Listele de stoc sunt late și scunde, așa că vederea strict laterală într-un cadru 2:1 este alegerea obișnuită: fiecare unitate este orientată la fel și stă pe aceeași linie de bază. trim=1&padding=6 decupează pe mașină înainte de încadrare, astfel încât un Hilux și un Yaris umplu rândul la fel; fit=contain păstrează pânza exact la 640×320, cu margini transparente. Pagina de detalii folosește front-3-4 la 1024, iar cele două partajează un cache: o vopsea pe care nu ați specificat-o este argintie pe ambele.

CRM-ul rulează într-un browser, iar un browser nu trebuie să dețină niciodată cheia API. Când un ecran listează o pagină de stoc, serverul generează câte un URL semnat pentru fiecare înregistrare cu POST /api/v1/image-urls (până la cincizeci per apel; imaginea fiecărui URL se contorizează ca imagine de vehicul a lunii), iar pagina le încarcă la fel ca pe orice imagine. Pentru o înregistrare care rămâne în stoc luni de zile contează două setări:

• ttl_seconds: 604800 cu renew: true: URL-ul continuă să funcționeze după TTL-ul de șapte zile, iar 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ă. Lunile în care nimeni nu se uită la mașină nu contorizează nimic.
• Un Idempotency-Key pentru fiecare pagină a sincronizării: o cerere reîncercată redă primul răspuns și nu generează nimic de două ori.

Restricționați cheia de generare la originea CRM-ului din panoul de control, iar un URL care ajunge pe alt site va răspunde cu 403. Revocarea cheii invalidează toate URL-urile generate cu ea. Dacă imaginile de vehicule ale planului pentru luna respectivă s-au epuizat, o reînnoire răspunde cu 402, iar același URL funcționează din nou când limita se resetează sau când treceți la un plan superior. Întregul ciclu de viață este descris în documentația URL-urilor semnate.

• SDK: client.decodeVin(vin, { year? }), client.resolve(query), client.getImage({ vehicle, … }) și client.createImageUrls(…), ca mai sus.
• MCP: decode_vin, resolve_vehicle, get_car_image și create_car_image_urls fac parte din setul de instrumente de bază, astfel încât un asistent care are sistemul de stoc în context poate răspunde la „fotografie pentru stocul 4471” pe baza VIN-ului din înregistrare. Configurarea este descrisă pe pagina MCP; câmpurile și erorile decodorului sunt în documentația VIN.