Bilbilder for auksjonsannonser

En auksjonskatalog publiseres så snart innleveringene er på plass: et VIN, et objektnummer og en salgsdato for hver bil. Bildene kommer når bilen når fram til tomten og fotografen når fram til bilen, noe som for en del av auksjonen skjer etter at budgivningen har åpnet. Inntil da er hvert av disse objektene en grå boks ved siden av en tekstlinje.

En katalogrendring fyller feltet med riktig årsmodell. En auksjon er også nettopp der en rendring aldri må utgi seg for å være bilen: budgiverne priser tilstanden, og en rendring viser ingen tilstand, fordi den ikke viser noe bestemt fysisk kjøretøy. Alt nedenfor følger av å holde fast ved begge deler samtidig.

• En rendring per objekt ut fra VIN-en, vist bare til objektets egne bilder kommer.
• En katalogvelger for objektene der VIN-en ikke lar seg dekode.
• En merknad på bildet: «Katalogbilde, ikke dette objektet».
• Én URL per auksjonsobjekt, opprettet én gang under en Idempotency-Key, og gyldig så lenge auksjonen varer.

GET /api/v1/vin/{vin} er gratis. Når katalogen har kjøretøyet, inneholder svaret data.vehicle.id, den stabile ID-en som skal lagres på objektet; dekodet utstyrsversjon, karosseri og motor blir værende i objektets tekst. Katalogen spenner fra 1990 til 2027, så de eldre bilene på en auksjon rendres like godt som de nyeste. Forsikringsveiledningen går gjennom en dekoding felt for felt, og VIN-dokumentasjonen dekker delvise VIN-er og feil.

Noen objekter kommer uten et VIN som lar seg dekode: et kjøretøy bygd for et annet marked, et VIN som kilden har skrevet feil, et innleveringsskjema med årstall, merke og modell og ingenting annet. Gi innleveringsskjemaet tre nedtrekksmenyer som hentes fra GET /api/v1/vehicles, som er gratis og offentlig: ?year= viser merkene som har en modell det året, og ?year=&makeId= viser modellene til det merket, hver med kjøretøy-id-en for den årsmodellen.

Den samme katalogen er den åpne @meterapp/vehicle-db-pakken, så nedtrekksmenyene kan også kjøre offline mot den identiske listen. Uansett ender auksjonsobjektet opp med samme type ID som en dekodet VIN, og ingenting senere i flyten skriver bilnavnet som fritekst.

Når en hel innleveringsliste kommer på én gang, leser POST /api/v1/vehicles/check opptil 2 000 oppføringer per kall, hver slik listen skriver den og med objektnummeret som ref, og svarer på hver enkelt: et treff med id-en som skal lagres, forslag, ingen treff eller en ugyldig rad. Ingenting genereres og ingenting belastes; vehicles-dokumentasjonen har detaljene.

Sett merkingen på selve bildet, der budgiverens blikk havner, og i alt-teksten, ikke bare i beskrivelsen under. Tilstand, kilometerstand, skader, utstyr og lakken på bilen hører hjemme i objektteksten og, når de finnes, på fotografiene. Når fotografiene kommer, forsvinner det genererte bildet.

Opprett objektets URL ved registrering med POST /api/v1/image-urls og en Idempotency-Key laget av auksjonen og objektet, med bokstaver, sifre, ., _, : og -. URL-en teller bildet sitt som et av månedens kjøretøybilder når den opprettes, så uten en nøkkel ville et nytt registreringsforsøk opprette en ekstra URL. Med nøkkel:

• Samme nøkkel med samme innhold i forespørselen innen 24 timer gir det første svaret på nytt, inkludert samme URL, med Idempotent-Replayed: true og uten ny belastning.
• Samme nøkkel med en annen body gir 422, og et nytt forsøk som går forbi den første forespørselen, gir 409 med Retry-After. Fastsett derfor alt i body-en, også levetiden, når auksjonsobjektet opprettes, og lagre det sammen med objektet.
• Lagre også URL-en på objektet: nøkkelen beskytter nye forsøk, og den lagrede URL-en er det sidene leser resten av auksjonen.

En hel katalog som importeres på én gang, kan opprette opptil 50 auksjonsobjekter per kall, med én nøkkel per batch; hver URL i svaret gjengir kjøretøyet og alternativene den ble opprettet for.

ttl_seconds kan være opptil 604800 (7 dager); en lengre verdi kuttes ned til dette. For et salg som avsluttes innen en uke, setter du den til tiden som gjenstår til avslutningen. Da slutter plassholderen å virke samtidig med budgivningen, og deretter svarer URL-en med 403.

• Et tidsbestemt salg som varer lenger enn 7 dager: lag URL-en med renew: true, ttl_seconds satt til maksimum og renew_days som dekker salget. En fornyelse teller bildet én gang i måneden den skjer, og ingenting mer hvis det allerede er telt den måneden; uker der ingen åpner objektet, teller ingenting, og fornyelsen stopper ved renews_until.
• Behold max_uses på 0, som er standard: en ubegrenset URL kan mellomlagres offentlig så lenge den er gyldig, mens en begrenset URL er private, no-store og sender hver innlasting til opprinnelsesserveren.
• Begrens nøkkelen som lager signerte URL-er til auksjonens domener på dashbordet: Et objektbilde som kopieres til et annet nettsted, får svaret 403.

Hvert objekt er ett kjøretøybilde, kjøretøyet i sin lakk og visning, med mindre to objekter deler alle tre, og hver plan inkluderer et antall kjøretøybilder i måneden: Free 100, Pro 2 500 og Business 10 000; Enterprise forhandles. Et bilde som allerede er telt denne måneden, vises alltid, og en batch som ville overskride kvoten, avvises i sin helhet før noe telles, med planen og kvoten i svaret. Tilpass planen til objektene du legger ut i løpet av en måned. Markedsplasshistorien handler om å fordele en stor import innenfor grensene for forespørsler og renderinger.