Immagini di auto per annunci d'asta

Un catalogo d'asta viene pubblicato non appena arrivano i conferimenti: un VIN, un numero di lotto e una data di vendita per ogni auto. Le foto arrivano quando l'auto raggiunge il piazzale e il fotografo raggiunge l'auto, il che, per una parte della vendita, avviene dopo l'apertura delle offerte. Fino ad allora ciascuno di quei lotti è un riquadro grigio accanto a una riga di testo.

Un render di catalogo riempie lo spazio con l'anno modello giusto. Ma un'asta è anche proprio il luogo in cui un render non deve mai essere scambiato per l'auto: gli offerenti valutano le condizioni, e un render non ne mostra nessuna, perché non raffigura alcun veicolo fisico specifico. Tutto ciò che segue nasce dal tenere presenti entrambe le cose.

• Un render per lotto dal suo VIN, mostrato solo finché non arrivano le foto del lotto.
• Un selettore dal catalogo per i lotti il cui VIN non si decodifica.
• Un'etichetta sull'immagine: "Render da catalogo, non questo lotto".
• Un URL per lotto, generato una sola volta con un Idempotency-Key, valido per tutta la durata della vendita.

GET /api/v1/vin/{vin} è gratuito. Quando il catalogo contiene il veicolo, la risposta include data.vehicle.id, l'id stabile da memorizzare sul lotto; allestimento, carrozzeria e motore decodificati restano nel testo del lotto. Il catalogo copre gli anni dal 1990 al 2027, quindi i veicoli più datati di un'asta vengono renderizzati come i più recenti. La guida per le assicurazioni illustra una decodifica campo per campo e la documentazione VIN tratta VIN parziali ed errori.

Alcuni lotti arrivano senza un VIN decodificabile: un veicolo costruito per un altro mercato, un VIN digitato male dalla fonte, una scheda di conferimento con anno, marca e modello e nient'altro. Doti il modulo di conferimento di tre menu a tendina alimentati da GET /api/v1/vehicles, gratuito e pubblico: ?year= elenca le marche con un modello in quell'anno e ?year=&makeId= elenca i modelli di quella marca, ciascuno con l'id del veicolo per quell'anno modello.

Lo stesso catalogo è il pacchetto open @meterapp/vehicle-db, quindi i menu a tendina possono funzionare anche offline sulla stessa identica lista. In entrambi i casi il lotto contiene lo stesso tipo di id di un VIN decodificato e nessun componente a valle deve scrivere per esteso il nome di un'auto.

Quando arriva un'intera distinta di conferimento in una volta, POST /api/v1/vehicles/check legge fino a 2000 voci per chiamata, ciascuna scritta come nella distinta e con il numero di lotto come ref, e risponde a ognuna: una corrispondenza con l'id da salvare, suggerimenti, nessun risultato o una riga non valida. Non viene generato alcun render e non viene addebitato nulla; i dettagli sono nella documentazione dei veicoli.

Inserisca l'etichetta sull'immagine stessa, dove cade lo sguardo dell'offerente, e nel testo alternativo, non solo nella descrizione sottostante. Condizioni, chilometraggio, danni, optional e il colore effettivo dell'auto vanno nel testo del lotto e, quando ci sono, nelle foto. Quando arrivano le foto, il render va rimosso.

Generi l'URL del lotto al momento dell'acquisizione con POST /api/v1/image-urls e una Idempotency-Key ricavata dall'asta e dal lotto, con lettere, cifre, ., _, : e -. L'URL conta la sua immagine come immagine di veicolo del mese quando viene generato, quindi senza una chiave un'acquisizione ripetuta genererebbe un secondo URL. Con una chiave:

• La stessa chiave con lo stesso corpo della richiesta entro 24 ore ripete la prima risposta, URL compreso, con Idempotent-Replayed: true e senza un secondo addebito.
• La stessa chiave con un body diverso restituisce un 422, e un nuovo tentativo che supera la prima richiesta restituisce un 409 con un Retry-After. Quindi fissi tutto nel body, durata inclusa, quando il lotto viene creato, e lo memorizzi insieme al lotto.
• Salvi l'URL anche sul lotto: la chiave protegge i tentativi ripetuti e l'URL salvato è ciò che le pagine leggono per il resto dell'asta.

Un intero catalogo importato in una volta può generare fino a 50 lotti per chiamata, con una chiave per batch; ogni URL nella risposta riporta il veicolo e le opzioni per cui è stato generato.

ttl_seconds arriva fino a 604800 (7 giorni); un valore più lungo viene ridotto a quel limite. Per una vendita che si chiude entro la settimana, lo imposti sul tempo rimanente fino alla chiusura. Il segnaposto smette così di funzionare quando terminano le offerte, e da quel momento l’URL risponde 403.

• Una vendita a tempo più lunga di 7 giorni: generi l'URL con renew: true, ttl_seconds al massimo e renew_days che copra la durata della vendita. Un rinnovo conta l'immagine una volta nel mese in cui avviene, e nient'altro se era già stata conteggiata quel mese; le settimane in cui nessuno apre il lotto non contano nulla, e il rinnovo si ferma a renews_until.
• Mantenga max_uses a 0, il valore predefinito: un URL illimitato può essere memorizzato pubblicamente nella cache per tutta la sua durata, mentre uno con limite è private, no-store e invia ogni caricamento all’origine.
• Limiti la chiave di generazione ai domini della sua asta nella dashboard: un'immagine di un lotto copiata su un altro sito risponde 403.

Ogni lotto è un'immagine di veicolo, cioè il suo veicolo nella sua vernice e vista, a meno che due lotti non condividano tutti e tre gli elementi, e ogni piano include un certo numero di immagini di veicoli al mese: Free 100, Pro 2500 e Business 10.000; Enterprise è negoziato. Un'immagine già conteggiata questo mese viene sempre servita, e un batch che supererebbe la quota viene rifiutato per intero, prima che venga conteggiato qualsiasi cosa, con il piano e la quota indicati nella risposta. Dimensioni il piano in base ai lotti che pubblica in un mese. La storia del marketplace spiega come distribuire una grande importazione entro i limiti di frequenza e di rendering.