开放平台 / 基础资料 / 2.3 房间

2.3 房间

注意:

    所有接口需要传入 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

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

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


}