跳转至

异步接收模型展示数据包（回调）

功能说明

模型审核发布后，若开通此功能，众趣会自动触发异步打包任务，将模型展示所需的资源文件打包为 zip 并上传至 CDN。打包完成后，众趣通过独立的回调接口（非接收模型编辑数据（回调））向接入方推送下载地址。

与「接收模型编辑数据」回调的关系

对比项 接收模型编辑数据（回调） 本回调
触发时机 审核发布时同步触发 审核发布时触发异步任务，打包完成后回调
回调地址 接入方单独配置 接入方单独配置（与模型编辑数据回调地址不同）
数据内容 模型编辑相关字段（mid、户型图、实勘图等） zip 包下载地址
是否阻塞发布 若配置为先推送后发布，推送失败会导致发布失败 否，打包为后台异步任务

说明

  1. 此功能需联系众趣开通，并单独提供本回调接口地址。
  2. 未开通时，不会触发打包任务，也不会调用本回调。
  3. 开通后，审核发布时会同时触发「接收模型编辑数据」回调与本回调对应的异步打包任务；打包耗时取决于模型数据量，可能在模型编辑数据回调之后数分钟才完成。
  4. 若同一模型已有进行中的打包任务，不会重复触发。
  5. 打包失败时，当前不会向接入方发送失败通知。

实现步骤

  1. 接入方参照本文档进行开发
  2. 接入方按照本文档中的格式，提供数据包接收接口的地址到众趣
  3. 众趣方审核后开通此功能
  4. 开通后，每次模型审核发布且打包完成，众趣后台将调用此接口推送下载地址

数据接收接口规则

  1. 接口地址由接入方提供，示例：
http://customer-host.com/callback/receive_model_display_package

  1. 数据接收接口必须支持 POST 方法

  2. 数据接收接口必须能够处理 Content-Type 值为 application/json 的请求

  3. 业务数据以 json 格式包含在 POST 请求体中

  4. 当数据接收接口响应的 http status 值为 200 时，视为接口调用成功

  5. 本回调当前不使用与「接收模型编辑数据」相同的 URL 验签参数（app_id、timestamp、key）

请求示例

{
    "download_url": "https://download.3dnest.cn/zip_data/123/aad98744_tmlC_b6f9.zip",
    "order_id": 712234, 
    "model_id": "aad98744_tmlC_b6f9", 
    "hid": "D224688_H04LK27"
}

字段解释

名称 类型 是否必须 说明
download_url string 必须 模型展示数据包 zip 文件的下载地址
order_id int 必须 众趣拍摄订单ID
model_id string 必须 众趣模型ID
hid string 必须 房源ID

响应要求

接入方接口返回 HTTP 200 即可，众趣侧不校验响应体格式。