注意:
所有接口需要传入 Head信息,格式如下
参数 说明 类型 是否必须
appKey App Key String Y 开发者账号创建授权接入
clientTime 访问时间毫秒数 Int Y在30分钟内有效
version 客户端版本 String Y 固定值V1.0
signature 签名串 String Y
签名串生成规则见1.4.1签名算法
2.3.1 房间和客户导入
(1) 方法:
路径:api/rooms/add
类型:POST接口
(2) 接口参数
参数 说明 类型 是否必须
rooms json字符串(
[{buildingName 楼栋,
unitName 单元名称
floor 楼层
room房号, 房号必须为小区内唯一性编码
roomName房间名称,
bulidingArea 建筑面积
property 业务属性 1 住宅、2商业、3工业、4车位
customer 客户姓名
type: 类型 P个人 E企业
phone联系电话
telephone固定电话
joinDate 入住日期 yyyy-MM-dd
customerType住户类型 1 业主 2租户
},{}] ) String Y
access_token token String Y 1.4.3接口获得
pid 小区ID String Y
(3) 返回结果
{
“result”: “success”|“error”,
“data”: true|false,
“msg”: “操作成功”|“错误信息”,
“code”: 1|0,
“success”: true|false
}
2.3.2 房间入住客户提交审核
(1) 方法:
路径:api/rooms/audit
类型:POST接口
(2) 接口参数
参数 说明 类型 是否必须
rooms json字符串(
[
{
room 房号 我家云已经存在 如 2栋1-301,
roomId 房间id (房号或者房间id,必须传入1个)
customer 客户姓名
phone联系电话
type 住户类型 0业主,1家庭成员,2租户
sex : 0 男,1 女
certifyNo: 身份证
},{}] ) String Y,
ticket String Y 1.4.2接口获得,
pid 小区ID String Y
(3) 返回结果
{
“result”: “success”|“error”,
“data”: true|false,
“msg”: “操作成功”|“错误信息”,
“code”: 1|0,
“success”: true|false
}
2.3.3 房间更新
(1) 方法:
路径:api/rooms/update
类型:POST接口
(2) 接口参数
参数 说明 类型 是否必须
rooms json字符串(
[{buildingName 楼栋,
unitName 单元名称
floor 楼层
room房号, 房号必须为小区内唯一性编码
roomName房间名称,
bulidingArea 建筑面积
},{}] ) String Y
access_token token String Y 1.4.3接口获得
pid 小区ID String Y
(3) 返回结果
{
“result”: “success”|“error”,
“data”: true|false,
“msg”: “操作成功”|“错误信息”,
“code”: 1|0,
“success”: true|false
}