获取客户的安居客token
接口说明:
众趣调用客户接⼝,获取客户在安居客的授权token,方便众趣侧进行一键推送素材包至安居客
请求方式:
- POST
入参示例
{
"app_id": "F2rdmn7pf5R",
"timestamp": "1629171831200",
"request_id": "877573639233609728",
"sign": "90da587dc342b6621e6d24fffc655b9f",
"zq_house_id": "FY-123456",
"ajk_house_id": "FY-123456"
}
传入参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
app_id | string | 是 | app_id |
timestamp | string/int | 是 | 当前时间戳,单位为毫秒 |
request_id | string | 是 | 一个随机不重复的字符串,用于计算sign |
sign | string | 是 | 一段加密字符串,加密方式见下文 |
zq_house_id | string | 否 | 众趣房源id |
ajk_house_id | string | 否 | 安居客内网房源id |
sign计算方法:
sign = MD5(app_id + timestamp + app_secret + request_id)
注意:
timestamp
为请求时间的时间戳,单位为毫秒。允许与服务器接收到请求时间的误差为5分钟(有效时间5分钟)request_id
为接入方随机生成的唯一字符串,短时间内多次请求时,接入方需要保证这个值不重复。即在短时间内使用重复的request_id
请求,众趣方会认定这是非法请求。- app_id 和 app_secret 的生成,见业务对接。
- 此接口为众趣侧调用客户的接口,客户可自行选择是否进行验签,众趣侧生成签名的算法规则为上述规则。
- 2024年3月7日之后对接的客户, zq_house_id 和 ajk_house_id 这两个字段为必传。
响应参数示例
{
"msg": "success",
"code": 1,
"ajkToken": "",
"clientId": ""
}
响应参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
msg | string | 是 | 响应状态描述 |
code | int | 是 | 响应状态码 |
ajkToken | string | 是 | 安居客的token |
clientId | string | 是 | 安居客的clientId |
注意:
- 客户的接口应当满足: 当code 为-1时,表示获取token 失败。