재고가 DMS, 딜러 웹사이트, 마켓플레이스에 있다면 사진 찍는 사람이 사진을 두 번 올릴 필요가 없어야 해요. LotShow API는 바로 그걸 위해 만들었어요. 피드가 매장 사진을 보내면 LotShow가 스튜디오 사진을 돌려보내요.

키 받기

API 키는 프로와 엘리트 요금제에 포함돼요. 설정의 API 키에서 만들고 서버에 보관하세요. 키는 한 번만 표시돼요. 모든 엔드포인트와 페이로드는 API 페이지에서 확인할 수 있어요.

피드 연동의 구조

어떤 시스템을 쓰든 흐름은 같아요.

  1. 새 차, 또는 이미 있는 차의 새 사진이 피드에 들어와요.
  2. 시스템이 원하는 쇼룸과 웹훅 URL을 담아 그 사진을 POST /v1/jobs로 보내요.
  3. LotShow가 작업을 대기열에 넣고 크레딧 1개를 차감해요.
  4. 사진이 완성되면 LotShow가 완성된 이미지의 URL과 함께 웹훅을 호출해요.
  5. 시스템이 이미지를 해당 차량에 저장하고 게시해요.

이 흐름에는 사람이 필요 없어요. 그게 핵심이에요. 매장 직원은 계속 찍기만 하고, 사진은 구매자가 보는 곳에 도착해요.

사진 1장을 넣으면 스튜디오 사진 1장이

작업 하나에는 이미지 하나와 쇼룸 하나가 들어가요. 요청은 다음과 같아요.

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

응답은 작업 id와 queued 상태와 함께 바로 돌아와요. 어떤 작업 id가 어떤 재고 번호의 몇 번째 사진인지 직접 기록해 두세요. 웹훅이 도착하면 그 기록이 이미지가 들어갈 정확한 자리를 알려 줘요. vehicle 이름은 LotShow 재고에서 차 한 대의 사진을 하나의 차량으로 묶어 주기도 해요.

보낼 사진 정하기

모든 사진에 배경이 필요한 건 아니에요. 처음에는 차 뒤 장면이 가장 중요한 외관 사진만 보내고, 실내와 디테일 사진은 그대로 게시하는 게 좋아요. 그러면 스타일이 일관되고 크레딧 사용량도 예측할 수 있어요. 차 한 대에 외관 8컷이면 8크레딧이에요.

피드 전체에 쓸 기본 쇼룸을 하나 정하고 모든 작업에 넘기세요. 추천 차량에 다른 스타일을 주고 싶다면, 누군가 손으로 고르게 하지 말고 시스템에 필드로 만들어 두세요. 매장 기본 스타일 고르기 가이드에서 고르는 방법을 알려 드려요.

속도 조절

작업 하나가 사진 한 장이라서 외관 8컷인 차는 요청 8번이고, 키 하나로 1분에 120번까지 요청할 수 있어요. 월요일에 40대가 한꺼번에 입고되면 한 번에 몰아 보내지 말고 일정한 속도로 보내고, 각 작업이 끝났는지는 웹훅으로 확인하세요. 작업은 각각 따로 처리되니 사진 하나가 잘못돼도 나머지가 막히지 않아요.

작업이 실패하면

가끔은 사진을 완성할 수 없을 때가 있어요. 차가 프레임 가장자리에서 잘렸거나, 이미지가 너무 어둡거나, 파일이 손상된 경우예요. 그러면 job.completed 대신 job.failed 이벤트를 받고, 크레딧은 바로 잔액으로 돌아가요. 같은 이미지를 반복해서 다시 보내지 말고, 시스템에서 그 차를 재촬영 대상으로 표시하세요.

크레딧은 어디서나 똑같이
API는 웹 스튜디오와 같은 잔액을 써요. 완성 사진 1장에 1크레딧이고, 사진이 실패하면 자동으로 환불돼요. 50크레딧 $6.99, 250크레딧 $29.99 충전 팩은 구독이 필요 없어요.

준비하기

대부분의 작업은 내 시스템 쪽에서 이뤄져요. 새 사진이 시스템에 들어오는 지점을 찾고, 어떤 사진에 배경을 입힐지 정하고, 작업 id용 필드를 추가하고, 웹훅을 받을 HTTPS 엔드포인트를 준비하세요. 마지막 부분은 웹훅 기초 글에서 다뤄요. 그다음 설정에서 키를 만들고 첫 사진을 보내 보세요.