把库存数据源接入 LotShow API

如果您的库存存放在 DMS、车商网站或交易平台中，负责拍照的人就不应该把照片上传两次。LotShow API 正是为此而打造的：您的数据源发送一张车场照片，LotShow 回传一张棚拍图。

获取密钥

API 密钥随专业版和精英版提供。在“设置”的“API 密钥”中创建，并保存在您的服务器上：密钥只显示一次。所有端点和数据格式都在 API 页面上。

数据源集成的基本形态

无论您这边用的是什么系统，流程都是一样的：

1. 一辆新车，或一辆已有车辆的新照片，进入您的数据源。
2. 您的系统把这张照片发送到 POST /v1/jobs，并附上您想要的展厅和您的 webhook URL。
3. LotShow 将任务排入队列，并为它扣除 1 个点数。
4. 照片完成后，LotShow 带着成品图片的 URL 调用您的 webhook。
5. 您的系统把图片与对应车辆关联保存，然后发布。

这个流程中没有任何一步需要人工参与，这正是关键所在。车场里的人继续拍照，照片自动出现在买家看得到的地方。

一张照片进，一张棚拍图出

一个任务包含一张图片和一个展厅。请求是这样的：

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 对应哪个库存编号和哪个照片位置。webhook 到达时，这份记录会准确告诉您图片该放在哪里。vehicle 名称还会把一辆车的照片归入您 LotShow 库存中的同一个车辆。

决定发送哪些照片

并不是每张照片都需要背景。一个好的起点是：发送外观照片，因为车后的场景对它们影响最大；内饰和细节照片则直接原样发布。这样既能保持风格统一，点数用量也可预期：每辆车 8 张外观照片就是 8 个点数。

为整个数据源选定一个专属展厅，并在每个任务中传入。如果精选车辆需要不同的风格，就在您自己的系统里设置一个字段，而不是让人手动选择。我们的专属风格选择指南介绍了如何挑选。

控制节奏

每个任务对应一张照片，所以一辆有 8 张外观照片的车就是 8 个请求，每个密钥每分钟最多可发送 120 个请求。如果周一一次到了 40 辆车，请以稳定的节奏发送，不要一次性全部涌入，并让 webhook 告诉您每个任务何时完成。每个任务独立运行，一张有问题的照片不会拖累其他照片。

任务失败时

有时照片无法完成：车被画面边缘截断、图片太暗，或文件已损坏。这时您收到的是 job.failed 事件而不是 job.completed，点数会直接退回您的余额。请让系统把这辆车标记为需要重拍，而不是循环发送同一张图片。

做好准备

大部分工作在您这一侧完成。找出新照片进入系统的位置，决定哪些照片需要背景，添加一个存放任务 ID 的字段，再搭建一个能接收 webhook 的 HTTPS 端点。最后这一步可以参考我们的文章《Webhook 入门》。然后在“设置”中创建密钥，发送您的第一张照片。