安居客-模型上平台任务处理状态回调-同步至客户
接口说明:
此接口为客户提供的回调接口,模型上平台任务处理状态回调,同步至客户
请求方式:
入参示例
{
"app_id": "F2rdmn7pf5R",
"timestamp": "1629171831200",
"request_id": "877573639233609728",
"sign": "90da587dc342b6621e6d24fffc655b9f",
"ajk_house_id": "房源在安居客平台的内网编号",
"zq_house_id": "房源在众趣平台的编号",
"status": 1,
"threeDStatus": 2,
"statusDetail": "全景状态详情",
"threeDStatusDetail":"全景3D状态详细信息"
}
传入参数字段及含义:
字段名 |
类型 |
是否必传 |
含义 |
app_id |
string |
是 |
app_id |
timestamp |
string/int |
是 |
当前时间戳,单位为毫秒 |
request_id |
string |
是 |
一个随机不重复的字符串,用于计算sign |
sign |
string |
是 |
一段加密字符串,加密方式见下文 |
ajk_house_id |
string |
是 |
房源在安居客平台的内网平台编号 |
zq_house_id |
string |
是 |
房源在众趣平台的编号 |
status |
int |
是 |
状态码 |
threeDStatus |
|
是 |
3D状态码 |
statusDetail |
string |
是 |
全景状态详情 |
threeDStatusDetail |
string |
是 |
全景3D状态详细信息 |
参数status的枚举含义
序列 |
定义 |
备注 |
1 |
处理中 |
全景正在切图操作 |
2 |
处理失败 |
全景切图失败,无法进行后续流程 |
3 |
待关联 |
全景待关联标准库房源 |
4 |
审核中 |
全景信息审核中 |
5 |
审核通过 |
全景信息审核通过 |
6 |
审核驳回 |
全景信息审核不通过,需要附加失败原因 |
7 |
已删除 |
全景信息已删除 |
参数threeDStatus的枚举含义
序列 |
定义 |
0 |
待制作 |
1 |
制作成功 |
2 |
无法制作 |
3 |
等待付费 |
-1 |
初始状态 |
sign计算方法:
sign = MD5(app_id + timestamp + app_secret + request_id)
注意:
timestamp
为请求时间的时间戳,单位为毫秒。允许与服务器接收到请求时间的误差为5分钟(有效时间5分钟)
request_id
为接入方随机生成的唯一字符串,短时间内多次请求时,接入方需要保证这个值不重复。即在短时间内使用重复的request_id
请求,众趣方会认定这是非法请求。
- app_id 和 app_secret 的生成,见业务对接。
- 此接口为众趣侧调用客户的接口,客户可自行选择是否进行验签,众趣侧生成签名的算法规则为上述规则。
响应参数示例
{
"msg": "success",
"code": 1
}
响应参数字段及含义:
字段名 |
类型 |
是否必传 |
含义 |
msg |
string |
是 |
响应状态描述 |
code |
int |
是 |
响应状态码 |