Imagini auto pentru anunțurile de licitație

Un catalog de licitație este publicat imediat ce sosesc consignațiile: un VIN, un număr de lot și o dată de vânzare pentru fiecare mașină. Fotografiile vin când mașina ajunge în parc și fotograful ajunge la mașină, ceea ce, pentru o parte din vânzare, se întâmplă după deschiderea licitației. Până atunci, fiecare dintre aceste loturi este o casetă gri lângă un rând de text.

O randare din catalog umple caseta cu anul de model corect. Totuși, o licitație este exact locul unde o randare nu trebuie să treacă niciodată drept mașina: ofertanții evaluează starea, iar o randare nu arată nimic din ea, pentru că nu înfățișează niciun vehicul fizic anume. Tot ce urmează decurge din respectarea ambelor idei în același timp.

• O randare per lot pornind de la VIN-ul său, afișată doar până sosesc fotografiile proprii ale lotului.
• Un selector din catalog pentru loturile al căror VIN nu poate fi decodat.
• O etichetă pe imagine: „Randare din catalog, nu acest lot”.
• Un singur URL per lot, generat o singură dată sub un Idempotency-Key, valabil pe toată durata licitației.

GET /api/v1/vin/{vin} este gratuit. Când catalogul conține vehiculul, răspunsul include data.vehicle.id, ID-ul stabil de stocat pe lot; echiparea, caroseria și motorul decodate rămân în textul lotului. Catalogul acoperă perioada de la 1990 până la 2027, astfel încât stocul mai vechi al unei licitații se randează la fel ca cel mai nou. Ghidul pentru asigurări parcurge o decodare câmp cu câmp, iar documentația VIN acoperă VIN-urile parțiale și erorile.

Unele loturi sosesc fără un VIN care poate fi decodat: un vehicul fabricat pentru altă piață, un VIN tastat greșit de sursă, o fișă de consignație cu un an, o marcă și un model și nimic altceva. Adăugați în formularul de consignație trei liste derulante alimentate de GET /api/v1/vehicles, care este gratuit și public: ?year= listează mărcile care au un model în acel an, iar ?year=&makeId= listează modelele acelei mărci, fiecare cu id-ul vehiculului pentru acel an de model.

Același catalog este pachetul deschis @meterapp/vehicle-db, așa că listele derulante pot funcționa și offline, pe baza aceleiași liste. În ambele cazuri, lotul ajunge să conțină același tip de id ca un VIN decodat, iar nimic din aval nu mai scrie de mână numele unei mașini.

Când sosește deodată o listă întreagă de consignație, POST /api/v1/vehicles/check citește până la 2.000 intrări per apel, fiecare așa cum apare scrisă în listă și cu numărul lotului ca ref, și răspunde pentru fiecare: o potrivire cu id-ul de stocat, sugestii, nicio potrivire sau un rând invalid. Nimic nu este randat și nimic nu este taxat; detaliile se găsesc în documentația pentru vehicule.

Puneți eticheta pe imaginea în sine, acolo unde se oprește privirea licitantului, și în textul alternativ, nu doar în descrierea de dedesubt. Starea, kilometrajul, daunele, dotările și culoarea reală a mașinii își au locul în textul lotului și, odată ce există, în fotografii. Când sosesc fotografiile, randarea dispare.

Emiteți URL-ul lotului la preluare cu POST /api/v1/image-urls și un Idempotency-Key format din licitație și lot, din litere, cifre, ., _, : și -. URL-ul contorizează imaginea sa ca imagine de vehicul a lunii când este emis, așa că fără cheie o preluare reîncercată ar emite un al doilea URL. Cu o cheie:

• Aceeași cheie cu același corp, în decurs de 24 ore, reia primul răspuns, inclusiv același URL, cu Idempotent-Replayed: true și fără o a doua taxare.
• Aceeași cheie cu un corp diferit returnează 422, iar o reîncercare care o depășește pe prima cerere returnează 409 cu Retry-After. Așadar, fixați tot conținutul corpului, inclusiv durata de valabilitate, la crearea lotului și stocați-l împreună cu lotul.
• Salvați și URL-ul în lot: cheia protejează reîncercările, iar URL-ul salvat este cel pe care îl citesc paginile pe tot restul licitației.

Un catalog întreg importat dintr-odată poate genera URL-uri pentru până la 50 loturi per apel, cu o cheie pentru fiecare pachet; fiecare URL din răspuns indică vehiculul și opțiunile pentru care a fost generat.

ttl_seconds acceptă până la 604800 (7 zile); o valoare mai mare este redusă la această limită. Pentru o licitație care se încheie în aceeași săptămână, setați-l la timpul rămas până la închidere. Astfel, imaginea provizorie nu mai funcționează odată cu încheierea licitării, iar după aceea URL-ul răspunde cu 403.

• O licitație cu durată limitată mai lungă de 7 zile: emiteți URL-ul cu renew: true, ttl_seconds la valoarea maximă și renew_days acoperind durata licitației. O reînnoire contorizează imaginea o singură dată în luna în care are loc și nimic în plus dacă a fost deja contorizată în acea lună; săptămânile în care nimeni nu deschide lotul nu se contorizează deloc, iar reînnoirea se oprește la renews_until.
• Păstrați max_uses la 0, valoarea implicită: un URL nelimitat poate fi stocat public în cache pe toată durata sa de valabilitate, în timp ce unul limitat este private, no-store și trimite fiecare încărcare către serverul de origine.
• Restricționați cheia de generare la domeniile licitației dumneavoastră din panoul de control: o imagine de lot copiată pe alt site răspunde cu 403.

Fiecare lot reprezintă o imagine de vehicul — vehiculul său, în vopseaua și vederea sa —, cu excepția cazului în care două loturi au toate trei elementele în comun, iar fiecare plan include un număr de imagini de vehicul pe lună: Free 100, Pro 2.500 și Business 10.000; Enterprise se negociază. O imagine deja contorizată luna aceasta este întotdeauna servită, iar o cerere grupată care ar depăși alocarea este refuzată integral, înainte de a se contoriza ceva, cu planul și alocarea incluse în răspuns. Dimensionați planul în funcție de loturile pe care le listați într-o lună. Povestea marketplace explică cum să eșalonați un import mare în limitele de rată și de randare.