安居客点云素材包结果通知(回调)
接口说明:
众趣回调客户接⼝,返回安居客的点云素材包链接(该接⼝由客户提供)
请求方式:
- POST
Headers:
Content-Type : application/json;charset=UTF-8
传入参数字段及含义:
| 参数名 | 是否必须 | 参数类型 | 参数描述 |
|---|---|---|---|
| zq_model_id | 是 | string | 众趣模型id |
| zq_house_id | 是 | string | 房源id |
| status | 是 | string | 响应状态,可选值 success、failed |
| file_md5 | 否 | string | ⽂件的MD5值 |
| oss_file_path_url | 否 | string | 素材包地址 |
| process_desc | 否 | string | 处理失败时的描述信息 |
| task_id | 是 | string | 任务id |
process_desc示例:
| process_desc |
|---|
| 下载点位数据遇到未知的错误 |
| 下载点位数据失败 |
| 文件解冻异常 |
| point_id值不存在 |
| 请求自动化服务失败,请重试 |
| 当前设备类型不支持下载点云数据 |
| 当前设备类型不支持下载 |
| 从OSS下载点云素材包出现异常请检查 |
| 上传OSS出现异常,请检查后重试 |
成功请求示例:
{
"zq_model_id":"b04bf6f8_ocHa_b6f9",
"zq_house_id":"房源id",
"status":"success",
"file_md5":"24ff4105cabf53ee7c6814e1ec4bab50",
"task_id":"5ff40e41-6e7f-4121-b2ee-0a36b9d19e62",
"oss_file_path_url":"https://download.3dnest.cn/b04bf6f8_ocHa_b6f9/customer_2022-08-15-08-59-32.zip"
}
失败请求示例:
{
"zq_model_id":"b04bf6f8_ocHa_b6f9",
"zq_house_id":"房源id",
"status":"failed",
"task_id":"5ff40e41-6e7f-4121-b2ee-0a36b9d19e62",
"process_desc":"下载点位数据遇到未知的错误"
}
响应规则:
回调接口的响应需要符合回调接口规则中的要求,支持以下两种响应方式:
方式一: 当响应体的Content-Type为text/plain;charset=utf-8时,成功的响应字符串需要为success(忽略大小写)
HTTP/1.1 200 OK
Content-Type: text/plain;charset=utf-8
success
方式二: 当响应体的Content-Type为application/json;charset=utf-8时,code=1表示响应成功
{
"msg": "ok",
"code": 1
}
如果响应失败,后台服务器会重复进行回调,每次回调间隔为30s, 4m, 30m, 1h。