Staat je voorraad in een DMS, op een dealerwebsite of op een marktplaats, dan zouden de mensen die de foto's maken ze niet twee keer hoeven te uploaden. Precies daarvoor is de LotShow API gebouwd: je feed stuurt een terreinfoto, en LotShow stuurt een studiofoto terug.

Een sleutel aanmaken

API-sleutels horen bij Pro en Elite. Maak er een aan in Instellingen, onder API-sleutels, en bewaar hem op je server: hij wordt maar één keer getoond. Alle endpoints en payloads staan op de API-pagina.

Hoe een feedkoppeling eruitziet

Welk systeem er aan jouw kant ook draait, de cyclus is altijd dezelfde:

  1. Een nieuwe auto, of een nieuwe foto van een auto die je al hebt, komt in je feed binnen.
  2. Je systeem stuurt die foto naar POST /v1/jobs, met de gewenste showroom en de URL van je webhook.
  3. LotShow zet de job in de wachtrij en rekent er één credit voor.
  4. Is de foto klaar, dan roept LotShow je webhook aan met de URL van het afgewerkte beeld.
  5. Je systeem koppelt het beeld aan de auto en publiceert het.

Nergens in die cyclus is een mens nodig, en daar gaat het juist om. De mensen op het terrein blijven fotograferen, en de foto's komen aan waar kopers ze zien.

Eén foto erin, één studiofoto eruit

Een job neemt één beeld en één showroom. Een request ziet er zo uit:

curl https://api.lotshow.com/v1/jobs \
  -H "Authorization: Bearer $LOTSHOW_KEY" \
  -F image=@stock-4471-front.jpg \
  -F backdrop=white-hall \
  -F vehicle=stock-4471 \
  -F webhook=https://yourdms.com/hooks/lotshow

De response komt meteen terug met een job-id en de status queued. Houd zelf bij welk job-id bij welk voorraadnummer en welke fotopositie hoort. Komt de webhook binnen, dan vertelt die administratie je precies waar het beeld heen moet. De naam in vehicle groepeert de foto's van een auto bovendien tot één voertuig in je Voorraad in LotShow.

Bepaal welke foto's je stuurt

Niet elke foto heeft een achtergrond nodig. Een goede eerste regel: stuur de buitenfoto's, waar de scène achter de auto het meest uitmaakt, en publiceer interieur- en detailfoto's zoals ze zijn. Zo blijft de uitstraling consistent en het aantal credits voorspelbaar: acht buitenfoto's per auto is acht credits.

Kies één huisshowroom voor de hele feed en geef die bij elke job mee. Moeten uitgelichte auto's er anders uitzien, maak daar dan een veld van in je eigen systeem in plaats van een keuze die iemand met de hand maakt. Onze gids over een vaste stijl kiezen legt uit hoe je kiest.

Tempo

Elke job is één foto, dus een auto met acht buitenfoto's is acht requests, en elke sleutel kan 120 requests per minuut doen. Komen er op maandag veertig auto's tegelijk binnen, stuur ze dan in een gelijkmatig tempo in plaats van in één enorme golf, en laat de webhooks je vertellen wanneer elke auto klaar is. Elke job loopt op zichzelf, dus één slechte foto houdt de rest niet op.

Als een job mislukt

Soms kan een foto niet worden afgewerkt: de auto valt aan de rand van het beeld weg, het beeld is te donker of het bestand is beschadigd. Dan krijg je een job.failed-event in plaats van job.completed, en gaat de credit direct terug naar je saldo. Laat je systeem de auto markeren voor een nieuwe foto in plaats van hetzelfde beeld in een lus opnieuw te sturen.

Credits werken overal hetzelfde
De API put uit hetzelfde saldo als de Web Studio: één credit per afgewerkte foto, automatisch terugbetaald als een foto mislukt. Aanvulpakketten van 50 credits voor $6.99 of 250 voor $29.99 werken zonder abonnement.

Aan de slag

Het meeste werk gebeurt aan jouw kant. Zoek uit waar nieuwe foto's je systeem binnenkomen, bepaal welke foto's een achtergrond moeten krijgen, voeg een veld toe voor het job-id en zet een HTTPS-endpoint op dat een webhook kan ontvangen. Ons artikel Webhooks 101 behandelt dat laatste deel. Maak daarna een sleutel aan in Instellingen en stuur je eerste foto.