Si tu inventario vive en un DMS, en la web de un concesionario o en un marketplace, quienes hacen las fotos no deberían tener que subirlas dos veces. La LotShow API está hecha justo para eso: tu feed envía una foto del patio y LotShow devuelve una foto de estudio.

Cómo conseguir una clave

Las claves de API vienen con Pro y Elite. Crea una en Ajustes, en Claves de API, y guárdala en tu servidor: solo se muestra una vez. Todos los endpoints y payloads están en la página de la API.

Cómo es una integración de feed

Sea cual sea el sistema que tengas, el ciclo es el mismo:

  1. Un auto nuevo, o una foto nueva de un auto que ya tienes, llega a tu feed.
  2. Tu sistema envía esa foto a POST /v1/jobs, con el showroom que quieres y la URL de tu webhook.
  3. LotShow pone el trabajo en cola y descuenta un crédito por él.
  4. Cuando la foto está terminada, LotShow llama a tu webhook con la URL de la imagen terminada.
  5. Tu sistema guarda la imagen asociada al auto y la publica.

Nada de ese ciclo necesita a una persona, y de eso se trata. El equipo del patio sigue fotografiando y las fotos llegan adonde las ven los compradores.

Entra una foto, sale una foto de estudio

Un trabajo recibe una imagen y un showroom. Una solicitud se ve así:

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

La respuesta llega al instante con un id de trabajo y el estado queued. Lleva tu propio registro de qué id de trabajo corresponde a qué número de stock y a qué posición de foto. Cuando llegue el webhook, ese registro te dirá exactamente dónde va la imagen. El nombre que pasas en vehicle también agrupa las fotos de un auto en un solo vehículo en tu Inventario de LotShow.

Decide qué fotos enviar

No todas las fotos necesitan un fondo. Una buena regla para empezar es enviar las tomas exteriores, donde la escena detrás del auto importa más, y publicar las del interior y los detalles tal cual. Así la imagen se mantiene coherente y el número de créditos es predecible: ocho tomas exteriores por auto son ocho créditos.

Elige un showroom de la casa para todo el feed y pásalo en cada trabajo. Si los autos destacados deben tener otra imagen, conviértelo en un campo de tu propio sistema en lugar de una decisión que alguien toma a mano. Nuestra guía para elegir un estilo de la casa explica cómo hacerlo.

Ritmo de envío

Cada trabajo es una foto, así que un auto con ocho tomas exteriores son ocho solicitudes, y cada clave puede hacer 120 solicitudes por minuto. Si una entrega trae cuarenta autos un lunes, envíalos a un ritmo constante en lugar de en una sola ráfaga enorme, y deja que los webhooks te avisen cuando cada uno esté listo. Cada trabajo se procesa por separado, así que una foto mala no puede retrasar al resto.

Cuando falla un trabajo

A veces una foto no se puede terminar: el auto queda cortado en el borde del encuadre, la imagen está demasiado oscura o el archivo está dañado. Entonces recibes un evento job.failed en lugar de job.completed, y el crédito vuelve directo a tu saldo. Haz que tu sistema marque el auto para repetir la foto en lugar de reenviar la misma imagen una y otra vez.

Los créditos funcionan igual en todas partes
La API usa el mismo saldo que el Studio web: un crédito por foto terminada, reembolsado automáticamente si una foto falla. Los paquetes de recarga de 50 créditos por $6.99 o 250 por $29.99 no requieren suscripción.

Antes de empezar

Casi todo el trabajo ocurre de tu lado. Localiza por dónde entran las fotos nuevas en tu sistema, decide qué fotos deben llevar fondo, añade un campo para el id de trabajo y prepara un endpoint HTTPS que pueda recibir un webhook. Nuestro artículo Webhooks 101 cubre esa última parte. Después, crea una clave en Ajustes y envía tu primera foto.