Jeśli dane o twoich autach są w DMS, na stronie dealera albo na portalu ogłoszeniowym, osoby robiące zdjęcia nie powinny wgrywać ich dwa razy. LotShow API powstało właśnie po to: twój feed wysyła zdjęcie z placu, a LotShow odsyła zdjęcie studyjne.

Jak zdobyć klucz

Klucze API są w planach Pro i Elite. Utwórz klucz w Ustawieniach, w sekcji Klucze API, i trzymaj go na swoim serwerze: zobaczysz go tylko raz. Wszystkie endpointy i formaty danych znajdziesz na stronie API.

Jak wygląda integracja z feedem

Niezależnie od tego, jaki system masz po swojej stronie, pętla jest taka sama:

  1. W twoim feedzie pojawia się nowe auto albo nowe zdjęcie auta, które już masz.
  2. Twój system wysyła to zdjęcie do POST /v1/jobs, z wybranym showroomem i adresem URL twojego webhooka.
  3. LotShow ustawia zadanie w kolejce i pobiera za nie jeden kredyt.
  4. Gdy zdjęcie jest gotowe, LotShow wywołuje twój webhook z adresem URL gotowego obrazu.
  5. Twój system zapisuje zdjęcie przy aucie i je publikuje.

Nic w tej pętli nie wymaga człowieka i właśnie o to chodzi. Ludzie na placu dalej fotografują, a zdjęcia trafiają tam, gdzie widzą je kupujący.

Jedno zdjęcie na wejściu, jedno studyjne na wyjściu

Zadanie przyjmuje jedno zdjęcie i jeden showroom. Żądanie wygląda tak:

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

Odpowiedź wraca od razu, z identyfikatorem zadania i statusem queued. Zapisuj u siebie, który identyfikator zadania należy do którego numeru magazynowego i której pozycji zdjęcia. Gdy przyjdzie webhook, ten zapis powie ci dokładnie, gdzie trafia zdjęcie. Nazwa vehicle grupuje też zdjęcia auta w jeden pojazd w sekcji Pojazdy w LotShow.

Zdecyduj, które zdjęcia wysyłać

Nie każde zdjęcie potrzebuje tła. Dobra zasada na start: wysyłaj ujęcia z zewnątrz, gdzie scena za autem ma największe znaczenie, a zdjęcia wnętrza i detali publikuj bez zmian. Dzięki temu wygląd jest spójny, a liczba kredytów przewidywalna: osiem ujęć z zewnątrz na auto to osiem kredytów.

Wybierz jeden firmowy showroom dla całego feedu i przekazuj go w każdym zadaniu. Jeśli wyróżnione auta mają wyglądać inaczej, zrób z tego pole w swoim systemie, a nie wybór, którego ktoś dokonuje ręcznie. Jak wybrać, podpowiada nasz poradnik o wyborze firmowego stylu.

Tempo

Każde zadanie to jedno zdjęcie, więc auto z ośmioma ujęciami z zewnątrz to osiem żądań, a każdy klucz może wysłać 120 żądań na minutę. Jeśli w poniedziałek dostawa przywiezie czterdzieści aut, wysyłaj je w równym tempie, a nie jednym ogromnym zrywem, i pozwól webhookom informować cię, kiedy każde jest gotowe. Każde zadanie działa osobno, więc jedno złe zdjęcie nie wstrzyma reszty.

Gdy zadanie się nie uda

Czasem zdjęcia nie da się ukończyć: auto jest ucięte na krawędzi kadru, zdjęcie jest za ciemne albo plik jest uszkodzony. Wtedy zamiast job.completed dostajesz zdarzenie job.failed, a kredyt od razu wraca na twoje saldo. Niech twój system oznaczy auto do ponownego zdjęcia, zamiast w kółko wysyłać to samo zdjęcie.

Kredyty działają wszędzie tak samo
API korzysta z tej samej puli co Web Studio: jeden kredyt za gotowe zdjęcie, zwracany automatycznie, gdy zdjęcie się nie uda. Pakiety doładowań, 50 kredytów za $6.99 lub 250 za $29.99, nie wymagają subskrypcji.

Zanim zaczniesz

Większość pracy dzieje się po twojej stronie. Ustal, gdzie nowe zdjęcia wpadają do twojego systemu, zdecyduj, które zdjęcia mają dostać tło, dodaj pole na identyfikator zadania i przygotuj endpoint HTTPS, który odbierze webhook. Tę ostatnią część omawia nasz wpis Webhooki od podstaw. Potem utwórz klucz w Ustawieniach i wyślij pierwsze zdjęcie.