Se o seu estoque fica em um DMS, no site de uma revenda ou em um marketplace, quem fotografa não deveria ter que subir as fotos duas vezes. A LotShow API foi feita exatamente para isso: o seu feed envia uma foto do pátio, e o LotShow devolve uma foto de estúdio.

Como conseguir uma chave

As chaves de API vêm com Pro e Elite. Crie uma em Configurações, em Chaves de API, e guarde-a no seu servidor: ela aparece uma única vez. Todos os endpoints e payloads estão na página da API.

O formato de uma integração por feed

Seja qual for o sistema do seu lado, o ciclo é o mesmo:

  1. Um carro novo, ou uma foto nova de um carro que você já tem, entra no seu feed.
  2. O seu sistema envia essa foto para POST /v1/jobs, com o showroom desejado e a URL do seu webhook.
  3. O LotShow coloca o job na fila e desconta um crédito por ele.
  4. Quando a foto fica pronta, o LotShow chama o seu webhook com a URL da imagem pronta.
  5. O seu sistema associa a imagem ao carro e a publica.

Nada nesse ciclo precisa de uma pessoa, e essa é a ideia. Quem está no pátio continua fotografando, e as fotos chegam onde os compradores as veem.

Uma foto entra, uma foto de estúdio sai

Um job recebe uma imagem e um showroom. Uma requisição fica assim:

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

A resposta volta na hora, com um id de job e o status queued. Guarde seu próprio registro de qual id de job pertence a qual número de estoque e a qual posição de foto. Quando o webhook chegar, esse registro diz exatamente para onde vai a imagem. O nome enviado em vehicle também agrupa as fotos de um carro em um só veículo no seu Estoque do LotShow.

Decida quais fotos enviar

Nem toda foto precisa de cenário. Uma boa regra inicial é enviar as fotos externas, em que o fundo atrás do carro mais importa, e publicar as fotos internas e de detalhes como estão. Assim o visual fica padronizado e o consumo de créditos, previsível: oito fotos externas por carro são oito créditos.

Escolha um showroom padrão para o feed inteiro e envie-o em todo job. Se carros em destaque devem ter outro visual, transforme isso em um campo no seu próprio sistema, em vez de uma escolha feita à mão. Nosso guia sobre como escolher um estilo padrão mostra como decidir.

Ritmo de envio

Cada job é uma foto, então um carro com oito fotos externas são oito requisições, e cada chave pode fazer 120 requisições por minuto. Se uma entrega despejar quarenta carros numa segunda-feira, envie em ritmo constante em vez de uma rajada enorme, e deixe os webhooks avisarem quando cada um estiver pronto. Cada job roda separadamente, então uma foto ruim não segura as outras.

Quando um job falha

Às vezes uma foto não pode ser concluída: o carro está cortado na borda do quadro, a imagem está escura demais ou o arquivo está corrompido. Nesse caso você recebe um evento job.failed em vez de job.completed, e o crédito volta direto para o seu saldo. Faça o seu sistema marcar o carro para uma nova foto, em vez de reenviar a mesma imagem em loop.

Os créditos funcionam igual em todo lugar
A API usa o mesmo saldo do Web Studio: um crédito por foto pronta, reembolsado automaticamente quando uma foto falha. Pacotes de recarga de 50 créditos por $6.99 ou 250 por $29.99 dispensam assinatura.

Antes de começar

A maior parte do trabalho acontece do seu lado. Descubra onde as fotos novas entram no seu sistema, decida quais fotos devem receber cenário, crie um campo para o id do job e configure um endpoint HTTPS que possa receber um webhook. Nosso post Webhooks 101 trata dessa última parte. Depois, crie uma chave em Configurações e envie sua primeira foto.