开放平台 / 基础资料 / 2.4 客户

2.4 客户

注意:

    所有接口需要传入 Head信息,格式如下

 

    参数 说明 类型 是否必须

    appKey App Key String Y 开发者账号创建授权接入

    clientTime 访问时间毫秒数 Int Y在30分钟内有效

    version 客户端版本 String Y   固定值V1.0

    signature 签名串 String Y


     签名串生成规则见1.4.1签名算法


2.4.1客户变更查询

(1) 方法:

路径:api/customers/changes


类型:GET接口


(2) 接口参数

参数 说明 类型 是否必须



pid String 项目id

beginDate 开始时间  ,样例: 2018-01-01

endDate 结束时间, 和开始时间小于等于1个月

ticket 有效票据 String 1.3.2接口获得



(3) 返回结果

{


“result”: “success”|“error”,


“data”:  

 "rows": [   
         {   

         phone 账号

         name String 客户姓名         

        address String 住址

        date  string 发生日期

        type  string 类型: 1. 迁出 2. 更名  

        },

     ], 


“msg”: “操作成功”|“错误信息”,


“code”: 1|0,


“success”: true|false


}



2.4.2 客户迁出

迁出房间

(1) 方法:

路径:api/customers/joinout

类型:POST接口


(2) 接口参数

参数 说明 类型 是否必须

 room房号 String Y

 phone联系电话 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.4.3 客户更名

根据电话号码判断存在则更新名称、性别、身份证

(1)方法:
路径:/api/customers/update
类型:Post接口

(2)接口参数
参数 说明 类型 是否必须

access_token token String Y  1.4.3接口获得

pid String 项目id

detail_info:   string   json格式,如

      {              
              "name": "姓名",        
              "phone": "电话",            

               sex :  0 男,1 女

               certifyNo: 身份证

          }     


(3) 示例 https://api.wojiacloud.com/api/customers/update


(4) 返回结果
{
  "code": 1,
  "data": {    
            

  },
  "msg": "成功", 
  "result": "success", 
  "success": true