一键上安居客
接口说明:
客户通过此接口启动一键上安居客的任务。
众趣侧自动生成模型的全景素材包,并将素材包自动上传至安居客平台。
需要客户提供3个接口配合完成。
- 获取安居客token的接口
- 安居客对接:上传绑定房源处理结果
- 安居客对接:模型上平台任务处理状态回调
请求路径:
{HostName}/api/v2/op/openapi/bind_ajk/?platform_id=xxxxxx
请求方式:
- POST
Headers:
{
"Content-Type": "application/json;charset=UTF-8",
"Authorization": "gAAAAABhG3g4Fd2NiMHocf8r-PVZCp1Xku3Rn1brr5wMPQNqkpqV8HrvZDfeYtdGdQrN_eTWaRvr1V5lPMda_kLaJvuYOyUruVWZJ6EH84WWu7sK51zxZibSUO4Huhzv9lGeDQg9ITeZ88JXg1ddG-kRdXIY7Qkic6XSXFXpA4lPNUtLB-pkEOM="
}
接⼝校验:
token获取请查看 身份验证-获取token
基于token请求接口,校验token
url查询参数示例
{
"platform_id" : "partner_xxxx"
}
url查询参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
platform_id | string | 是 | 平台来源码 |
POST请求体参数示例
{
"ajk_house_id": "456789123",
"zq_house_id": "zq房源编号"
}
传入参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
zq_house_id | string | 是 | 房源在众趣平台的编号 |
ajk_house_id | string | 是 | 房源在安居客平台的内网编号 |
cate_id | int | 否 | 房源种类,默认值为13 (11:整租;12:合租 13:二手房 14: 写字楼) |
- 注意 ajk_house_id:这个编号是经纪公司内网房源编号
响应参数示例
{
"msg": "success",
"code": 1,
"detail": "接口响应状态的详细描述",
"data": {
}
}
响应参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
msg | string | 是 | 响应状态描述 |
code | int | 是 | 响应状态码 |
消息码code取值及说明:
code取值 | 说明 | 任务创建状态 |
---|---|---|
1 | 任务接收成功 | 成功 |
2 | 缺少必要的参数 | 失败 |
3 | 无此模型,请检查参数后重试 | 失败 |
4 | 找到了多个对应模型:请检查参数后重试 | 失败 |
5 | 接口出现未知的错误,detail中包含详细原因 | 失败 |
1002 | 失败,缺少校验参数 | 失败 |
1003 | 失败,超时 | 失败 |
1004 | 失败,签名校验失败 | 失败 |
7 | 模型已有正在进行的任务或者已经绑定房源 | 失败 |
8 | 当前模型的中心点位超出限制 | 失败 |
9 | 发布任务到生产服务器出现未知异常 | 失败 |