Autoafbeeldingen voor veilingkavels

Een veilingcatalogus gaat online zodra de inzendingen binnen zijn: per auto een VIN, een kavelnummer en een veilingdatum. De foto's komen pas als de auto op het terrein staat en de fotograaf bij de auto is, wat voor een deel van een veiling pas gebeurt nadat het bieden is geopend. Tot die tijd is elk van die kavels een grijs vak naast een regel tekst.

Een catalogusrender vult het vak met het juiste modeljaar. Maar een veiling is ook precies de plek waar een render nooit voor de echte auto mag doorgaan: bieders prijzen de staat in, en een render toont die niet, omdat hij geen specifiek fysiek voertuig afbeeldt. Alles hieronder volgt uit het tegelijk vasthouden aan beide.

• Een render per kavel op basis van het VIN, alleen getoond tot de eigen foto's van de kavel binnen zijn.
• Een cataloguskiezer voor de kavels waarvan het VIN niet kan worden gedecodeerd.
• Een label op de afbeelding: "Catalogusrender, niet deze kavel".
• Eén URL per kavel, één keer aangemaakt onder een Idempotency-Key, geldig zolang de veiling loopt.

GET /api/v1/vin/{vin} is gratis. Als de catalogus het voertuig bevat, bevat het antwoord data.vehicle.id, de stabiele id om bij de kavel op te slaan; de gedecodeerde uitvoering, carrosserie en motor blijven in de tekst van de kavel. De catalogus loopt van 1990 tot 2027, dus de oudere voorraad van een veiling wordt net zo gerenderd als de nieuwste. De verzekeringsgids loopt een decodering veld voor veld door, en de VIN-documentatie behandelt gedeeltelijke VIN's en fouten.

Sommige kavels komen binnen zonder VIN die te decoderen is: een voertuig gebouwd voor een andere markt, een VIN die de bron verkeerd heeft ingetypt, een inbrengformulier met een jaar, een merk en een model en verder niets. Geef het inbrengformulier drie keuzelijsten die gevuld worden door GET /api/v1/vehicles, dat gratis en openbaar is: ?year= toont de merken met een model in dat jaar, en ?year=&makeId= toont de modellen van dat merk, elk met het voertuig-id van dat modeljaar.

Dezelfde catalogus is het open pakket @meterapp/vehicle-db, zodat de keuzelijsten ook offline met precies dezelfde lijst kunnen werken. Hoe dan ook krijgt de kavel hetzelfde soort id als een gedecodeerd VIN, en verderop in de keten hoeft niets een autonaam uit te schrijven.

Als een volledige inzendlijst in één keer binnenkomt, leest POST /api/v1/vehicles/check tot 2.000 regels per aanroep, elk zoals de lijst het spelt en met het kavelnummer als ref, en beantwoordt elke regel: een match met de id om op te slaan, suggesties, geen resultaat of een ongeldige regel. Er wordt niets gerenderd en niets in rekening gebracht; de vehicles-documentatie bevat de details.

Plaats het label op de afbeelding zelf, waar het oog van een bieder valt, en in de alt-tekst, niet alleen in de beschrijving eronder. Staat, kilometerstand, schade, opties en de lak van de auto horen in de kaveltekst en, zodra ze er zijn, op de foto's. Zodra de foto's binnen zijn, verdwijnt de render.

Maak de URL van de kavel bij de intake aan met POST /api/v1/image-urls en een Idempotency-Key samengesteld uit de veiling en de kavel, met letters, cijfers, ., _, : en -. De URL telt de afbeelding als voertuigafbeelding van de maand op het moment dat hij wordt aangemaakt, dus zonder sleutel zou een herhaalde intake een tweede URL aanmaken. Met een sleutel:

• Dezelfde sleutel met dezelfde body binnen 24 uur herhaalt het eerste antwoord, inclusief dezelfde URL, met Idempotent-Replayed: true en zonder dat er opnieuw wordt afgerekend.
• Dezelfde sleutel met een andere body geeft een 422, en een nieuwe poging die het eerste verzoek inhaalt, geeft een 409 met een Retry-After. Leg daarom alles in de body vast, de levensduur inbegrepen, wanneer het kavel wordt aangemaakt, en sla het op bij het kavel.
• Sla de URL ook op bij het kavel: de sleutel beveiligt nieuwe pogingen, en de opgeslagen URL is wat de pagina's de rest van de veiling gebruiken.

Bij het in één keer importeren van een hele catalogus kunt u tot 50 kavels per aanroep aanmaken, met één sleutel per batch; elke URL in het antwoord vermeldt het voertuig en de opties waarvoor hij is aangemaakt.

ttl_seconds loopt tot 604800 (7 dagen); een langere waarde wordt daartoe ingekort. Stel het voor een veiling die binnen de week sluit in op de resterende tijd tot de sluiting. De placeholder werkt dan niet meer zodra het bieden stopt, en daarna geeft de URL 403 terug.

• Een veiling met tijdslimiet die langer duurt dan 7 dagen: maak de URL aan met renew: true, ttl_seconds op het maximum en renew_days voor de duur van de veiling. Een verlenging telt de afbeelding één keer in de maand waarin die valt, en niets extra als de afbeelding die maand al was geteld; weken waarin niemand de kavel opent, tellen niet mee, en de verlenging stopt bij renews_until.
• Houd max_uses op 0, de standaardwaarde: een onbeperkte URL is gedurende zijn hele levensduur openbaar cachebaar, terwijl een begrensde URL private, no-store is en elke keer laden naar de origin stuurt.
• Beperk de sleutel waarmee u URL's aanmaakt tot de domeinen van uw veiling in het dashboard: een kavelafbeelding die naar een andere site is gekopieerd, geeft 403 terug.

Elke kavel is één voertuigafbeelding, het voertuig in zijn lak en weergave, tenzij twee kavels alle drie gemeen hebben, en elk abonnement bevat een aantal voertuigafbeeldingen per maand: Free 100, Pro 2.500 en Business 10.000; over Enterprise wordt onderhandeld. Een afbeelding die deze maand al is geteld, wordt altijd geleverd, en een batch die het tegoed zou overschrijden, wordt in zijn geheel geweigerd voordat er iets wordt geteld, met het abonnement en het tegoed in het antwoord. Stem het abonnement af op het aantal kavels dat u per maand aanbiedt. Het verhaal over marktplaatsen beschrijft hoe u een grote import doseert binnen de rate- en renderlimieten.