linkdood-web-sdk 1.0.5 → 1.0.7

package/docs/thrift/ap.thrift

@@ -17,7 +17,7 @@ struct VerifyInfo {
     一旦票不正确，应该改为密码登陆
 */
 struct LoginParam {
-    1:  byte    userType            // 帐号类型 1：手机号 2：第三方关联,3：邮箱 4：用户ID,6：豆豆号，7:使用自定义拓展字段来进行登陆 -1：传用户ID但票验证 100:湖北公安第三方认证
+    1:  byte    userType            // 帐号类型 1：手机号 2：第三方关联,3：邮箱 4：用户ID,6：豆豆号，7:使用自定义拓展字段来进行登陆, 8:emm的sso登录，95:验证码注册加登录，96:验证码登录， 97：更换设备时短信验证登录 99:SAML认证用户 -1：传用户ID但票验证
     2:  string  user
     3:  string  pwd
     4:  string  macAddr             // 必填不能为空
@@ -25,6 +25,7 @@ struct LoginParam {
 
     16: optional byte   tick        // 踢人策略 1: 强制踢(登录) 2: 不踢人(重连)
     17: optional string deviceInfo
+    //TODO可能已经不用
     18: optional byte   status      /*TODO(H.) 该字段将会替换 PluginParam, reportPluginStatus 将会被缺消 */
 
     20: optional byte status_flag   // -1：离线，1:在线；2:隐身,3:忙碌,4:离开,5:请勿打扰,6:想聊天, 默认在线
@@ -33,12 +34,12 @@ struct LoginParam {
     23: optional i64 sdkid          // SDKID 默认为0，注意：开放平台应用请忽略该字段
     24: optional string markSign    // 注意：对于连豆豆的正常应用忽略该字段，如果是开放平台应用则填入标识
     25: optional string redirectUri //auth回调地址
-    26: optional i64 inviteCodeID
-    28: optional string sdkVersion  //客户端sdk版本号
+    26: optional i64 inviteCodeID   //邀请注册时请携带GetVerifyCodeResult中的inviteCodeID
+    27: optional string thirdAuthParamJson  //第三方认证透传参数
     200: optional string ip        // 客户端不要使用该字段
-    201: optional string versionEx  //版本号兼容
 }
 
+//TODO可能要删除
 struct PluginParam {
 	1: byte   deviceType;
 	2: byte   status;    // 1 充电 2 非充电
@@ -80,7 +81,8 @@ struct Timestamp {
     21:  optional i64 whiteListTS;               /* 人员白名单如果有变化, 这里会有值 */
     23:  optional i64 dataDictID;		 /*　数据字典时间戳 */
     24:  optional i64 entBroadcastID;    /*  企业号时间戳 */
-
+    25:  optional i64 permissionID;      /*权限策略时间戳，设置级别关系时会更新时间戳*/
+    
     50:  i64 pushMessageID;             /* 推送消息(投票及公告)  */
     51: optional string serverTS        /* 服务端字典时间戳，json形式提供,包含的内容会后续说明16-4-15 */
 
@@ -88,15 +90,12 @@ struct Timestamp {
     122: optional list<i64>     webEmotionID;   /* 表情时间戳,分页 */
     202: i32 code;
     203: optional string what;
-
+    //TODO需要删除
     204: optional map<i64, EnterpriseTimestamp> enterprisesTs; /* key 企业id */ /// 将来会被删除， 用205 enTs替换
     205: optional  EnterpriseTimestamp enTs; //其中 企业组织时间戳 须通过getEntOrgsTimestamp单独获取
+
+
     206: optional i64 badWordsTs    // 服务器存储的敏感词的时间戳(游标)
-    207: optional i64 secWordsTs    // 服务器存储的涉密关键字的时间戳
-    254: optional i64 clientMenus    // 客户端动态菜单的时间戳
-    255: optional i64 appConfigTs    //公共号设置的时间戳29
-    256: optional i64 emoticonTs     // 表情包时间戳
-    257: optional i64 emoticonServerTs // 服务器表情包时间戳
 }
 
 struct VerifyParam {
@@ -106,8 +105,8 @@ struct VerifyParam {
 }
 
 struct LoginResult {
-    1:i32 code //100001575表示更换设备登录
-    2: optional string what         // 可能保存了image信息
+    1:i32 code   // 换设备错误码：100001575;第三方认证失败错误码:100001576
+    2: optional string what         // 可能保存了image信息;第三方认证失败时保存了json透传信息
 
     3: optional i32 sessionTimeout // session失效时间(秒),请在这段时间内关闭连接重新发送空请求
 
@@ -116,35 +115,12 @@ struct LoginResult {
     6: optional i64    serverTime  // 服务器当前时间
 
     7: optional string privateKey
-    8: optional string ticket     // 对于pc端跳转网页可以直接使用此票
+    8: optional string ticket     // 对于pc端跳转网页可以直接使用此票，当返回错误码为100001575时，即更换设备登录的时候，该字段用于保存用户注册手机号
     9: optional string area       // 返回区域码
     //10: optional string captcha   //验证码，当需要验证码登录时会填充该字段
     11: optional i64 remainLockTime;     //剩余锁定时长 ，毫秒
     12: optional i64 inviteUserID
     13: optional i64 registerTime //用户注册时间
-    14: optional string exinfo;   //拓展字典：{
-                                  //            "customerService":["key1","key2"], //我的客服 key1为parentId=20001的拓展字典的key
-                                  //            "crtInfo": {
-                                  //                           "url":"vrv.linkdood.cn",//证书续费地址，只有绑定管理员的账户才会返回该字段
-                                  //                           "serverTime":1213454435000, //服务期当前时间（时间戳，毫秒）
-                                  //                           "crtBTime":1213454435000,   //证书有效期开始时间（时间戳，毫秒）
-                                  //                           "crtETime":1213454435000,   //证书有效期到期时间（时间戳，毫秒）
-                                  //                        }
-                                  //            "MHInfo":{
-                                  //                 "adminUrl":"/mbox" //魔盒管理中心
-                                  //            }
-                                  //        }
-                                  //            
-                                  //            "verifiedInfo":{
-                                  //                 "region":"CN",      // COM海外 , 其他中国
-                                  //                 "personSize":10      // int 国内用户数/10
-                                  //            },
-                                  //            
-                                  //            "commInfo":{
-                                  //                  "authority":1   // int,权限相关字段(按位与，按位或); 1 管理员; 2 待定; 4 待定
-                                  //            }
-                                  //        }
-    15: optional byte value_byte;//即buddySwitch，用户注册后是否加好友;0:加好友，1：不加好友
 }
 
 struct SessionTicket {
@@ -328,9 +304,6 @@ struct OperateBuddyBean {
    8: optional string backgroundURL   // 聊天背景地址
    /*key设置类型  1：个人设置，value设置值 1为接收提醒 2表示不提醒仅显示数字 3:为免打扰*/
    9:optional map<i32,i32> buddySetting
-   /*邀请码ID*/
-   10:optional string inviteCode
-
 }
 
 struct AllMessageCursorResult {
@@ -539,46 +512,53 @@ struct EnURet {
     3: optional list<aphead.EnterpriseUserBean> us
 }
 
+
 struct OnlineBean {
     1: i64 userID     // 用户ID
     2: i64 connectID  // 连接ID
 
     3: byte deviceType // 1：PC；2：手机；3：pad；4：网页
-    4: byte flag       // -1：离线，1:在线；2:隐身,3:忙碌,4:离开,5:请勿打扰, 6:想聊天
-    5: optional i64 operateDate;  //操作时间
-    6: byte onlineStatus //在线状态 1:在线；2:会议中,3:忙碌,4:飞机上,5:请勿打扰,6:自定义
-    7: optional string explain //状态说明
-    8: string deviceInfo;
-    9: i64 loginTime;
+    4: byte flag    //-1：离线，1:在线；2:隐身,3:忙碌,4:离开,5:请勿打扰,6:想聊天,7:强制下线,8:暂时离线,9:未激活
+    /*操作时间*/
+    5: optional i64 operateDate;
 }
 
 /////////////////////////////////////////////////
 /* 
     1. type 类型
         0, 设置token和appleID (默认值，客户端可以不用设置该值);
-           需要参数appleID，token,value_str_1；返回code
+           需要参数appleID，token；返回code
         1. 设置云后台在线状态 . 需要字段vb1设置云后台在线(true 在线, false 不在线),vb2设置应用在线(true在线), 返回code
-        3.设置token 
-            传入参数：
-                mapParams
-                key："appleID", value:"Google"  不能为空，必填，小米可填写"Google"
-                key: "token",   value:token值  
-                "connectID" ,connectID
-                "deviceType2" , deviceType2  0苹果   2 google 
-        返回：
-                code ：0 成功
-        7.根据传入的用户列表，查询用户的状态，包括在线（隐身算离线），离线和未激活
-    			请求参数：    listI64    用户userID列表
-    			返回参数：    onlineBeans  用户在线状态信息
+        2. 设置当前人的会话对象ID（中电科）
+           需要参数value64：聊天对象，用户ID　或　群ID
+	3.设置token 
+		传入参数：
+		    mapParams
+			key："appleID", value:"XiaoMi"  不能为空，必填，小米可填写"XiaoMi"
+			key: "token",   value:token值  
+			      "connectID" ,connectID
+			      "deviceType2" , deviceType2  0苹果 1 华为  2 google 3 中电科EMM  4 小米
+		返回：
+		    code ：0 成功   
+	4. 新增或修改onlineExt
+		请求参数：     value_str_1
+		返回参数:   	result
+	5. 删除onlineExt
+		请求参数：     value_str_1
+		返回参数:   	result
+	6.查询onlineExt
+		请求参数：     value_str_1
+		返回参数:	params
+	7.根据传入的用户列表，查询用户的状态，包括在线（隐身算离线），离线和未激活
+		请求参数：    listI64    用户userID列表
+		返回参数：    onlineBeans  用户在线状态信息
 	8.根据群ID查询在线和离线的群成员数量
-          请求参数：     value64    群ID
-          返回参数：     mapStrI64  key：onlineNum 在线成员数 key:offlineNum 离线成员数
-    9.单聊时，获取对方状态并保存会话记录到缓存，此人状态变化时会推送（包括陌生人）
-          请求参数：   value64   目标userID
-          返回参数：   olBean    目标在线状态
-    10.根据传入的用户列表，获取同一账号不同设备类型的在线信息，包括在线（隐身算离线），离线和未激活
-        请求参数：   listI64    用户userID列表
-        返回参数：   onlines    同一账号所有类型登录设备的在线信息
+		请求参数：   value64    群ID
+		返回参数：   mapStrI64  key:onlineNum 在线成员数   key:offlineNum 离线成员数
+	9.单聊时，获取对方状态并保存会话记录到缓存，此人状态变化时会推送（包括陌生人）
+		请求参数：   value64   目标userID
+		返回参数：   olBean    目标在线状态
+
 */
 struct OnlineParam {
    1: optional byte type            
@@ -586,20 +566,20 @@ struct OnlineParam {
    3: optional string token         // ios tokena
    4: optional bool vb1;
    5: optional bool vb2;
-   6: optional i64 value64;
-   7: optional map<string,string> mapParams;
-   /* 此处兼容主线版，从8开始，方便中间添加，表示voip推送token */
-   8: optional string value_str_1;
+   6: optional i64 value64
+   7: optional map<string,string> mapParams
+   8: optional string value_str_1
    9: optional list<i64> listI64
 }
 
 struct OnlineRet {
    1: i32 code
    2: optional string what
+   3: optional aphead.Result result
+   4: optional map<string,string> params
    5: optional list<OnlineBean> onlineBeans
    6: optional OnlineBean olBean
    7: optional map<string,i64> mapStrI64
-   8: optional map<i64,list<OnlineBean>> onlines
 }
 
 //////////////////////////
@@ -702,8 +682,6 @@ struct GetBuddyOnlineResult {
 
 struct OnlineState {
     1: byte flag; // 1:在线,2:隐身,3:忙碌,4:离开,5:请勿打扰
-    2: optional byte onlineStatus; //1:在线；2:会议中,3:忙碌,4:飞机上,5:请勿打扰,6:自定义
-    3: optional string explain; /*状态说明*/
 }
 
 struct IosNoticeInfo {
@@ -915,7 +893,7 @@ struct GetPersonDefinitionResult {
 
 struct SettingList {
     1: byte addType    // 1 黑名单 2 白名单
-    2: optional i64 id // 当addType==2的时候设置， 表示企业ID
+    2: optional i64 id // 当addType==2的时候设置， 表示企业ID,addType传1时设置该值，targetID传自己，可以查询自己是否在对方黑名单中
 }
 
 struct QueryEnUserListResult {
@@ -1014,118 +992,15 @@ struct RegURet {
 }
 */
 /////////////////////////////////////////////////
-/*
-type 类型
-    1, 批量查询多个用的设置项
-
-    *
-    *   返回结果请参数NewPersonalDataSwitch
-
-    参数：userIdList 用户id列表
-         value32  用户可见项（详情见内容）
-         使用时非特殊情况请勿将value32 设置为0，
-        * 最新查询个人设置项调用方法，value32 = 0 表示查询个人所有设置项
-        * 目前value32为1的时候， 表示设置是否显示在线信息         ，value=1表示显示，value=2表示不显示，默认1显示
-        * 目前value32为2的时候， 表示设置表示生日可见性              ，value:1：所有人可见 2：仅好友可见 3：仅自己可见，默认1
-        * 目前value32为3的时候， 表示设置豆豆号查找                    ，value=1表示可以通过此号查找我，value=2表示不允许，默认1可以查找
-        * 目前value32为4的时候， 表示设置手机号查找        ，value=1表示可以通过此号查找我，value=2表示不允许，默认1可以查找
-        * 目前value32为5的时候， 表示设置邮箱号查找        ，value=1表示可以通过此号查找我，value=2表示不允许，默认1可以查找
-        * 目前value32为6的时候， 表示设置分享更新         ，value=1表示提示更新，value=2不提示更新，默认1表示提示更新
-        * 目前value32为7的时候， 表示设置新消息通知是否提醒    ，value=1表示提醒，value=2不提醒，默认1提醒 
-        * 目前value32为8的时候， 表示设置全局勿扰模式       ，value=1表示关闭 value=2表示打开，默认1，时间段在扩展字段内存储，json格式
-        * 目前value32为9的时候， 表示设置推送通知提示音      ，value表示定义的声音名，默认default
-        * 目前value32为10的时候，表示设置用户的扩展信息      ，value表示用户扩展json字段
-        * 目前value32为11的时候，表示设置电话可见性        ，value: 1：所有人可见 2：仅好友可见 3：仅自己可见，默认1
-        * 目前value32为12的时候，表示设置多服务新消息通知是否提醒  ，value=1表示始终提醒，value=2不始终提醒，默认2不始终提醒
-        * 目前value32为13的时候，表示设置多服务V标好友始终提醒  ，value=1表示始终提醒，value=2不始终提醒，默认1始终提醒
-        * 目前value32为14的时候，表示设置多服务@相关人始终提醒          ，value=1表示始终提醒，value=2不始终提醒，默认1始终提醒
-        * 目前value32为15的时候，表示设置邮箱可见性设置                ，value: 1：所有人可见 2：仅好友可见 3：仅自己可见，默认1
-        * 目前value32为16的时候，表示设置好友验证方式                  ，value: 1：需要验证信息,2:不允许任何人添加,3:允许任何人添加，默认1
-        * 目前value32为17的时候，表示设置V标(好友，群)提醒模式      ，value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1
-        * 目前value32为18的时候，表示设置@相关人提醒模式                ，value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1
-        * 目前value32为19的时候，表示设置全局通知消息内容模式       ，value: 1:通知详情，2：通知源，隐藏内容 3:完全隐藏，默认2
-        * 目前value32为21的时候，个人设置里的群验证方式
-    返回：code 透传错误码
-         userDataSwitchMap: map<i64,list<aphead.NewPersonalDataSwitch>> 对应用户的配置详情
-
-    2,  设置个人信息（new） 提供对个人的所有设置，包含(个人开关设置，全局勿扰设置，自定义声音，自定义用户扩展信息以及setting)等
-        *   目前switchType为1的时候， 表示设置是否显示在线信息             ，value=1表示显示，value=2表示不显示，默认1显示
-        *   目前switchType为2的时候， 表示设置表示生日可见性                  ，value:1：所有人可见 2：仅好友可见 3：仅自己可见，默认1
-        *   目前switchType为3的时候， 表示设置豆豆号查找                        ，value=1表示可以通过此号查找我，value=2表示不允许，默认1可以查找
-        *   目前switchType为4的时候， 表示设置手机号查找                ，value=1表示可以通过此号查找我，value=2表示不允许，默认1可以查找
-        *   目前switchType为5的时候， 表示设置邮箱号查找                ，value=1表示可以通过此号查找我，value=2表示不允许，默认1可以查找
-        *   目前switchType为6的时候， 表示设置分享更新                 ，value=1表示提示更新，value=2不提示更新，默认1表示提示更新
-        *   目前switchType为7的时候， 表示设置新消息通知是否提醒        ，value=1表示提醒，value=2不提醒，默认1提醒   
-        *   目前switchType为8的时候， 表示设置全局勿扰模式               ，value=1表示关闭 value=2表示打开，默认1，时间段在扩展字段内存储，json格式
-        *   目前switchType为9的时候， 表示设置推送通知提示音          ，value表示定义的声音名，默认default
-        *   目前switchType为10的时候，表示设置用户的扩展信息          ，value表示用户扩展json字段
-        *   目前switchType为11的时候，表示设置电话可见性                ，value: 1：所有人可见 2：仅好友可见 3：仅自己可见，默认1
-        *   目前switchType为12的时候，表示设置多服务新消息通知是否提醒  ，value=1表示始终提醒，value=2不始终提醒，默认2不始终提醒
-        *   目前switchType为13的时候，表示设置多服务V标好友始终提醒  ，value=1表示始终提醒，value=2不始终提醒，默认1始终提醒
-        *   目前switchType为14的时候，表示设置多服务@相关人始终提醒          ，value=1表示始终提醒，value=2不始终提醒，默认1始终提醒
-        *   目前switchType为15的时候，表示设置邮箱可见性设置                  ，value: 1：所有人可见 2：仅好友可见 3：仅自己可见，默认1
-        *   目前switchType为16的时候，表示设置好友验证方式                    ，value: 1：需要验证信息,2:不允许任何人添加,3:允许任何人添加，默认1
-        *   目前switchType为17的时候，表示设置V标(好友，群)提醒模式      ，value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1
-        *   目前switchType为18的时候，表示设置@相关人提醒模式                  ，value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1
-        *   目前switchType为19的时候，表示设置全局通知消息内容模式         ，value: 1:通知详情，2：通知源，隐藏内容 3:完全隐藏，默认2
-        *   目前switchType为25的时候，表示设置服务器别名
-        setNewPersonDataSwitch(1:aphead.NewPersonalDataSwitch personalDataSwitch);  
-
-
-        参数：value32 用户可见项(switchType), 类型详情内容为上述所列
-             value_str 服务器别名 , switchType = 25
-
-        返回： code 错误码
-                100005000 成功
-                100005001 参数不全
-                100 参数错误，未知type
-                11100 服务器内部错误 
-              what 结果信息
-*/
-
-/*
-    3,  获取用户搜索可配置开关 (getClientSearchSetting)
-        参数： 无
-
-        返回： code 错误码
-                0 成功
-                100 参数错误，未知type
-                11100 服务器内部错误 
-                xxxxx 获取数据开关项失败
-
-              what 结果信息
-
-    4, 修改用户搜索可配置开关
-        参数： value_str  ===> searchKey 开关的key
-              value_type ===> value 开关的值: 1开2关
-
-        返回： code 错误码
-                0 成功
-                100 参数错误，未知type
-                11100 服务器内部错误 
-                xxxxx 修改数据开关项失败
-
-              what 结果信息
-
-              pSearSwitchList: list<aphead.PersonalSearchDataSwitch> 搜索字段详情list
-*/    
 struct SettingSParam {
     1: optional byte type
     2: optional i64 value64
-    3: optional list<i64> userIdList
-    4: optional i32 value32
-    5: optional string value_str
-    6: optional byte value_type
-    7: optional aphead.CombinationOrder cmd
 }
 
 struct SettingRet {
     1: i32 code
     2: optional string what
-    3: optional map<string, string> mapKsVs
-    4: optional map<i64,list<aphead.NewPersonalDataSwitch>> userDataSwitchMap
-    5: optional list<aphead.PersonalSearchDataSwitch> pSearSwitchList
-    6: optional list<aphead.CombinationOrder> cmdList
+    3: optional map<string, string> mapKsVs;
 }
 
 /////////////////////////////////////
@@ -1152,23 +1027,17 @@ struct SettingRet {
        返回：
         code: 0   成功；  100:参数错误；11100：服务器内部错误
         wbbPage 工作台轮播图分页返回结果
-    4,根据parentId集合查询数据字典
+	4,根据parentId集合查询数据字典
 		传入参数:
 		1:list<i32> listids  //父id的集合
 		返回:
 			list<aphead.EnterpriseDictionary>
-    6.客户端查询菜单配置 (queryClientMenus)
-       参数:
-       value_1: elogo（服务器标识）
-       返回:
-       aphead.ClientMenuResult clientMenuResult
 		
 */
 struct EnDParam{
     1: optional byte type
     2: optional map<string,string> wheremap
-    3: optional list<i32> listids
-    4: optional string value_1
+	3: optional list<i32> listids
 }
 
 struct EnDRet{
@@ -1176,7 +1045,6 @@ struct EnDRet{
     2: optional string what
     3: optional list<aphead.EnterpriseDictionary> listEnDic
     4: optional aphead.WorkBenchBannerPage wbbPage
-    5: optional aphead.ClientMenuResult clientMenuResult
 }
 //////////////////////////////////////////
 /*
@@ -1336,7 +1204,7 @@ struct MultiOpSTRet {
 /*
 type 类型
         1, 分页查询应用市场应用信息。
-	   传入参数：query 
+	   传入参数：query (里面userid必须写入)
 	   返回：
 		code:　0:成功，100:参数错误，11100:内部错误
 		page:  aphead.SmallMarketAppPage
@@ -1481,67 +1349,11 @@ type 类型
    19.删除待提醒消息
    参数：value64_1  ==>id, 消息提醒id
    返回：code:　100013002:成功，100013003:失败，100:参数错误，11100:内部错误
-	     
-   21.根据用户ID获取用户待办事项列表信息
-   返回： 
-        code: 0:成功，100:参数错误，11100:内部错误
-        list<aphead.AgencyBean> listAgencyBean
-	
-	
-	22.客户端应用浏览器 应用服务开关总值
-   参数: value64_1 appId应用Id
-   返回： 
-        code: 0:成功，100:参数错误，11100:内部错误
-        value32_1 开关总值
-   23.客户端应用浏览器 帮助获取帮助列表
-   参数: aphead.SmallAppHelpParam smallAppHelpParam 应用帮助查询结构体
-   返回： 
-        code: 0:成功，100:参数错误，11100:内部错误
-        list<aphead.SmallAppHelp> listSmallAppHelp        
-*/
-/*
-   25.验证签名，接口鉴权 (authenticate)
-   参数：authenticateBean  验证签名接口鉴权bean
-   返回：
-        code: 100013102:成功，100:参数错误，11100:内部错误,
-              100013103:Account_token无效ACCESS_TOKEN过期,
-              100013104:url域名无效域名验证错误code
-              100013105:签名验证失败验证签名，验证不通过验证签名失败
-              100013106:jsApiList接口验证错误
-        what：描述
-        value_str_1： 结果数据
-   28.用户设置公共号配置项(setUserToAppConfig)
-   参数：userToAppConfig.appId公共号id
-        userToAppConfig.type类型
-        userToAppConfig.value
-   返回：
-        code: 0:成功
-              100:参数错误
-              11100:内部错误
-              100013006:失败
-   29.获取用户设置的公共号配置项列表(getUserToAppConfigList)
-   参数：userToAppConfig.timestamp时间戳
-        userToAppConfig.type类型(非必须)
-   返回：
-        list<aphead.UserToAppConfig> listUserToAppConfig
-        code: 0:成功
-              100:参数错误
-              11100:内部错误
-   32.忽略/隐藏app(ignoreSmallMarketAppInfo)
-   参数：aphead.IgnoreMarketAppBean ignoreMarketAppBean
-   返回：
-        code: 0:成功
-              100:参数错误
-              11100:内部错误
-              100013077:操作类型及数据关系不匹配
-              100013078:群应用无操作权限
-              100013079:应用号不存在
-        what：错误码说明
-   33.获取群应用接口/客户端工作台安装的应用(queryAllSmallMarketAppInfo)
-   参数：aphead.SmallMarketAppQueryParam query
-   返回：
-        code: 0:成功，100:参数错误，11100:内部错误
-        list<aphead.SmallMarketAppInfo> listSMAppInfo
+
+   20.客户端直接发送消息给公众号的第三方服务器
+   * 消息类型（messageType）:38 上报位置消息 暂时只支持38号消息，后续添加请添加者补充说明
+   * messageType=38,用户无感知上报位置消息,即便返回了错误码，也不能呈献给用户，所以对于38号消息只返回成功码 
+   返回： code=0 成功
 */
 
 struct PltFParam {
@@ -1558,10 +1370,6 @@ struct PltFParam {
     11: optional byte value8_2
     12: optional i32 value32_2
     13: optional aphead.ReminderMsg reminderMsg
-    14: optional aphead.SmallAppHelpParam smallAppHelpParam
-    15: optional aphead.AuthenticateBean authenticateBean
-    16: optional aphead.UserToAppConfig userToAppConfig
-    17: optional aphead.IgnoreMarketAppBean ignoreMarketAppBean
 }
 
 struct PltFRet {
@@ -1575,22 +1383,80 @@ struct PltFRet {
     8: optional list<aphead.SmallEntAppInfo> listEntAppInfo
     9: optional string value_str_1
     10: optional aphead.ReminderMsgPage reminderMsgPage
-    11: optional list<aphead.AgencyBean> listAgencyBean
-    12: optional list<aphead.SmallAppHelp> listSmallAppHelp
-    13: optional i32 value32_1
-    15: optional list<aphead.UserToAppConfig> listUserToAppConfig
+}
+
+/////////////////////////////////////////////
+/*
+type 类型
+        1, 单个查询表情
+	   传入参数：value_str_1	# 表情文件的md5Code
+	   返回：
+		code:　0:成功，100:参数错误，11100:内部错误
+		listEmotion:  list<aphead.Emoticon> listEmotion
+	2,单个查询表情包
+	   传入参数：value_str_1	# 表情包文件的md5Code
+	   返回：
+		code:　0:成功，100:参数错误，11100:内部错误
+		emotPkg: aphead.EmoticonPackage
+		
+	3,分页查询表情包
+	   传入参数：page	#填入 pageNum，pageSize
+	   返回：
+		code:　0:成功，100:参数错误，11100:内部错误
+		page:  aphead.EmoticonPackagePage
+	4,添加自定义表情
+	   传入参数：emoticon
+	   返回：
+		code:　0:成功，100:参数错误，801:md5Code不正确，802:md5Code文件已存在，11100:内部错误
+		result: aphead.EmoticonOPResult
+	5,删除自定义表情
+ 	   传入参数：emoticon 
+	   返回：
+		code:　0:成功，100:参数错误，801:md5Code不正确，11100:内部错误
+		result: aphead.EmoticonOPResult
+	6,根据表情包标识查询所有表情
+ 	   传入参数：value_str_1 	#表情文件的md5Code
+	   返回：
+		code:　0:成功，100:参数错误，11100:内部错误
+		listEmotion: list<aphead.Emoticon>
+	7,查询用户所有自定义表情
+	   返回：
+		code:　0:成功，100:参数错误，11100:内部错误
+		listEmotion: list<aphead.Emoticon>
+    8,根据表情包标签查询相关表情包集合
+       传入参数: value_str_1    #表情包标签
+       返回:
+        code:　0:成功，100:参数错误，11100:内部错误
+        listEmotPkg: list<aphead.EmoticonPackage>
+*/
+
+struct EmotParam {
+    1: optional byte type
+    2: optional string value_str_1
+    3: optional aphead.EmoticonPackagePage page
+    4: optional aphead.Emoticon emoticon
+}
+
+struct EmotRet {
+    1: i32 code
+    2: optional string what
+    3: optional aphead.EmoticonOPResult result
+    4: optional aphead.EmoticonPackage emotPkg
+    5: optional aphead.EmoticonPackagePage page
+    6: optional list<aphead.Emoticon> listEmotion
+    7: optional list<aphead.EmoticonPackage> listEmotPkg
 }
 //////////////////////////////////////////
 /*
 type 类型
     1, 查询公共配置单个时间戳
-        参数：value64_1：（查询员工级别时间戳传企业id，查询机器人时间戳传机器人appID）;  
-        value64_2  时间戳类型（查询员工级别时间戳传238，查询机器人时间戳传22）
+        参数：value64_1：（查询员工级别时间戳或查询工作台轮播图时间戳或查询帮助系统时间戳或数据字典时间戳传企业id，查询机器人时间戳传机器人appID）;  
+        value64_2  时间戳类型（查询员工级别时间戳传238，查询机器人时间戳传22，查询工作台轮播图时间戳传26，查询帮助系统时间戳传27，查询数据字典时间戳传23）
         为了兼容老版本，value64_2不传认为是查询机器人时间戳
         返回：
         code:　0:成功，100:参数错误，11100:内部错误
         value64_1：对应配置项的时间戳	
-	2, 查询数据字典时间戳 
+	2, 查询数据字典时间戳--此功能废弃，使用上面的接口获取数据字典时间戳 
 	   返回：
 		code:　0:成功，100:参数错误，11100:内部错误
 		value64_1:  数据字典的时间戳
@@ -1637,22 +1503,132 @@ struct RegURet {
 /*
 type 类型
     1.调用声网服务
-        1)用户聊天过程中,动态SubKey失效,重新获取SubKey
-        参数value_str: {"function" : "getSubKey", "param1" : "用户ID", "param2" : "企业ID", "param3" : "视频频道ID"}
-        返回value_str: {"code" : "0", "msg" : "SUCCESS", "result" : {"SubKey" : "XXXXXXXXXXX", "channelID" : "XXX"}}
-        如果result当中没有值,会设置result为空
-        2)用户同意视频邀请---加入单聊
-        参数value_str: {"function" : "joinSingle", "param1" : "邀请者ID", "param2" : "被邀请者ID", "param3" : "企业ID", "param4" : "视频频道ID"}
-        返回value_str: {"code" : "0", "msg" : "SUCCESS", "result" : {"SubKey" : "XXXXXXXXXXX", "channelID" : "XXX"}}
-        如果result当中没有值,会设置result为空
-        3)用户同意视频邀请---加入群聊
-        参数value_str: {"function" : "joinGroup", "param1" : "邀请者ID", "param2" : "被邀请者ID", "param3" : "企业ID", "param4" : "视频频道ID"}
-        返回value_str: {"code" : "0", "msg" : "SUCCESS", "result" : {"SubKey" : "XXXXXXXXXXX", "channelID" : "XXX"}}
-        如果result当中没有值,会设置result为空
-        4)用户退出视频聊天
-        参数value_str: {"function" : "outChat", "param1" : "退出用户ID", "param2" : "企业ID", "param3" : "视频频道ID", "param4" : "聊天时长"}
-        返回value_str: {"code" : "0", "msg" : "SUCCESS"}
+	 方法1: 获取许可(声网)
+	 参数：{"function":"getPermit","parame1":"企业ID"}
+	 成功返回（字符串）：{"code":100,"msg":"SUCCESS","result":{"VendorKey":"XXXXXXXXXX"}}
+
+	 方法2: 加入聊天
+	 参数：{"function":"joinChat","parame1":"用户ID","parame2":"企业ID","parame3","视频频道ID","parame4":"呼叫类型","parame5","SDK类型"}
+	 成功返回（字符串）：{"code":100,"msg":"SUCCESS","result":{"SubKey":"XXXXXXXXXXX","channelID":"XXXX","userID":"XXXX","VendorKey":""}}
+
+	 方法3: 退出聊天/同步聊天
+	 参数：{"function":"outChat","parame1":"用户ID","parame2":"企业ID","parame3","视频频道ID","parame4":"聊天时长","parame5":"退出类型","parame6","SDK类型"}
+	 成功返回（字符串）：{"code":100,"msg":"SUCCESS"}
+
+	 方法4: 用户聊天过程中，动态SubKey失效,重新获取SubKey(声网)
+	 参数：{"function":"getSubKey","parame1":"用户ID","parame2":"企业ID","parame3","视频频道ID"}
+	 成功返回（字符串）：{"code":100,"msg":"SUCCESS","result":{"SubKey":"XXXXXXXXXXX","channelID":"XXXX","userID":"XXXX"}}
+
+	 方法5: 获取打洞服务信息(西安)
+	 参数：{"function":"getServerInfo","parame1":"SDK类型"}
+	 成功返回（字符串）：{"code":100,"msg":"SUCCESS","result":{"stunServerAddr":"","turnAddr":"","account":"","password":""}}
+	 统一对外接口错误码:
+	 code:100->成功,110->执行异常,111->function名称错误
+    2.原生朋友圈
+    3.云盘
+        注释见下面
+*/
+
+/*
+         * folder
+         * 入参 {"function":"folder","pid":1,"userId":12415239841,"timestamp":12415239841}
+         * 出参 {"result":[{"createdAt":1500365555239,"encryptFileSize":41008,"fileCode":"100110011002","fileId":1500365555239001599,"fileName":"云盘改造","filePath":"http://172.16.8.95:9999/group1/M00/00/00/rBAIX1ltwvOEX2OCAAAAACZqgWs44.docx","fileReMark":"个人区-云盘改造","fileSize":41007,"fileSuffix":"docx","fileType":1,"image":false,"md5Hash":"3e8f81017e245637abdac56171979fdb","ownerId":12415239841,"pid":1,"secretKey":"suf98ij2i9hmj3l6","updatedAt":1500365555239,"uploaderId":12415239841,"uploaderName":"曹李强"},{"createdAt":1500365677522,"encryptFileSize":10560,"fileCode":"100110011003","fileId":1500365677522002862,"fileName":"学习","filePath":"http://172.16.8.95:9999/group1/M00/00/00/rBAIX1ltw22Efz7_AAAAAALW7xk73.xlsx","fileReMark":"个人区-学习","fileSize":10550,"fileSuffix":"xlsx","fileType":1,"image":false,"md5Hash":"d5182ffea3fbe40ffb01468367477c19","ownerId":12415239841,"pid":1,"secretKey":"f2osoul8ceuzd6s5","updatedAt":1500365677522,"uploaderId":12415239841,"uploaderName":"曹李强"}],"code":0,"msg":"SUCCESSS"}
+         *
+         *
+         *addFile
+         * 
+         * 入参 {"function":"addFile","file":{"encryptFileSize":288,"fileCode":"10011001","fileName":"desktop","filePath":"e0855.ini","fileReMark":"a-b-c","fileSize":288,"fileSuffix":"ini","fileType":1,"md5Hash":"abc","ownerId":111,"pid":1496892622384001700,"secretKey":"2a3atz1hcvlbx4u4","uploaderId":10385196713,"uploaderName":"aaaa","fileClass":"chat"}}
+         * 出参 {"result":{"createdAt":1500534363284,"encryptFileSize":288,"fileClass":"chat","fileCode":"100110011003","fileId":1500534363284001973,"fileName":"desktop(2)","filePath":"e0855.ini","fileReMark":"desktop(2)","fileSize":288,"fileSuffix":"ini","fileType":1,"image":false,"md5Hash":"abc","ownerId":111,"pid":1496892622384001700,"secretKey":"2a3atz1hcvlbx4u4","updatedAt":1500534363284,"uploaderId":10385196713,"uploaderName":"aaaa","validity":90},"code":0,"msg":"SUCCESSS"}
+         *
+         *deleteFile
+         * 
+         * 入参 {"function":"deleteFile","fileId":111}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *updateFile
+         * 
+         * 入参 {"function":"updateFile","file":{"fileName":"desktop","fileId":"1500365555239001599"}}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *getFileById
+         * 
+         * 入参 {"function":"getFileById","fileId":111}
+         * 出参 {"result":{"createdAt":1500365555239,"encryptFileSize":41008,"fileCode":"100110011002","fileId":1500365555239001599,"fileName":"desktop","filePath":"http://172.16.8.95:9999/group1/M00/00/00/rBAIX1ltwvOEX2OCAAAAACZqgWs44.docx","fileReMark":"个人区-云盘改造","fileSize":41007,"fileSuffix":"docx","fileType":1,"image":false,"md5Hash":"3e8f81017e245637abdac56171979fdb","ownerId":12415239841,"pid":1,"secretKey":"suf98ij2i9hmj3l6","updatedAt":1500536403503,"uploaderId":12415239841,"uploaderName":"曹李强"},"code":0,"msg":"SUCCESSS"}
+         *
+         *getFilesByHash
+         * 
+         * 入参 {"function":"getFilesByHash","hash":"3e8f81017e245637abdac56171979fdb"}
+         * 出参 {"result":[{"createdAt":1500365555239,"encryptFileSize":41008,"fileCode":"100110011002","fileId":1500365555239001599,"fileName":"desktop","filePath":"http://172.16.8.95:9999/group1/M00/00/00/rBAIX1ltwvOEX2OCAAAAACZqgWs44.docx","fileReMark":"个人区-云盘改造","fileSize":41007,"fileSuffix":"docx","fileType":1,"image":false,"md5Hash":"3e8f81017e245637abdac56171979fdb","ownerId":12415239841,"pid":1,"secretKey":"suf98ij2i9hmj3l6","updatedAt":1500536403503,"uploaderId":12415239841,"uploaderName":"曹李强"}],"code":0,"msg":"SUCCESSS"}
+         *
+         *searchFile
+         * 
+         * 入参 {"function":"searchFile","searchText":"desk","userId":12415239841}
+         * 出参 {"result":[{"createdAt":1500365555239,"encryptFileSize":41008,"fileCode":"100110011002","fileId":1500365555239001599,"fileName":"desktop","filePath":"http://172.16.8.95:9999/group1/M00/00/00/rBAIX1ltwvOEX2OCAAAAACZqgWs44.docx","fileReMark":"个人区-云盘改造","fileSize":41007,"fileSuffix":"docx","fileType":1,"image":false,"md5Hash":"3e8f81017e245637abdac56171979fdb","ownerId":12415239841,"pid":1,"secretKey":"suf98ij2i9hmj3l6","updatedAt":1500536403503,"uploaderId":12415239841,"uploaderName":"曹李强"}],"code":0,"msg":"SUCCESSS"}
+         *
+         *createTeam
+         * 
+         * 入参 {"function":"createTeam","file":{"fileCode":"10011001","fileName":"desktop","fileReMark":"a-b-c","fileType":2,"ownerId":111,"pid":1496892622384001700,"uploaderId":10385196713,"uploaderName":"aaaa"}}
+         * 出参 {"result":{"createdAt":1500537584023,"fileCode":"100110011005","fileId":1500537584023001446,"fileName":"desktop(1)","fileReMark":"desktop(1)","fileType":2,"image":false,"ownerId":111,"pid":1496892622384001700,"updatedAt":1500537584023,"uploaderId":10385196713,"uploaderName":"aaaa"},"code":0,"msg":"SUCCESSS"}
+*/
+
+/*
+         *
+         *teamAddMember
+         * 
+         * 入参 {"function":"teamAddMember","members":[{"fileId":111,"headImg":"","suserId":"111","createdAt":1500537824755,"userId":111,"sfileId":"111","userName":"张三","roleId":1}]}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *teamRemoveMember
+         * 
+         * 入参 {"function":"teamRemoveMember","members":[{"fileId":111,"headImg":"","suserId":"111","createdAt":1500537824755,"userId":111,"sfileId":"111","userName":"张三","roleId":1}]}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *teamResetMember
+         * 
+         * 入参 {"function":"teamResetMember","members":[{"fileId":111,"headImg":"","suserId":"111","createdAt":1500537824755,"userId":111,"sfileId":"111","userName":"张三","roleId":1}]}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *teams
+         * 
+         * 入参 {"function":"teams","userId":111}
+         * 出参 {"result":[{"createdAt":1500275014598,"encryptFileSize":0,"fileCode":"100110011001","fileId":1500275014598001902,"fileName":"2222","fileReMark":"个人区-2222","fileSize":0,"fileType":3,"image":false,"members":1,"ownerId":111,"pid":1,"roleId":1,"updatedAt":1500275014598,"uploaderId":111}],"code":0,"msg":"SUCCESSS"}
+         *
+         *teamMembers
+         * 
+         * 入参 {"function":"teamMembers","fileId":1500275014598001902}
+         * 出参 {"result":[{"createdAt":1500275014928,"fileId":1500275014598001902,"headImg":"","roleId":1,"roleName":"管理员","sfileId":"1500275014598001902","suserId":"111","updatedAt":1500275014928,"userId":111,"userName":"null"}],"code":0,"msg":"SUCCESSS"}
+         *
+         *roles
+         * 
+         * 入参 {"function":"roles","isShow":1}
+         * 出参 {"result":[{"createdAt":1495099097131,"isShow":1,"name":"管理员","orderNum":1,"permission":"上传,下载,创建团队,删除,重命名","roleID":1,"roleType":1,"status":1,"totalSize":-1,"updatedAt":0,"uploadSize":-1},{"createdAt":1495099097131,"isShow":1,"name":"普通成员","orderNum":2,"permission":"上传,下载,重命名","roleID":2,"roleType":2,"status":1,"totalSize":-1,"updatedAt":1496892694229,"uploadSize":-1}],"code":0,"msg":"SUCCESSS"}
+         *
+         *getRoleByID
+         * 
+         * 入参 {"function":"getRoleByID","roleId":1}
+         * 出参 {"result":{"createdAt":1495099097131,"isShow":1,"name":"管理员","orderNum":1,"permission":"11111","roleID":1,"roleType":1,"status":1,"totalSize":-1,"updatedAt":0,"uploadSize":-1},"code":0,"msg":"SUCCESSS"}
+         *
+         *addRole
+         * 
+         * 入参 {"function":"addRole","role":{"isShow":1,"name":"管理员2","orderNum":1,"permission":"11111","totalSize":-1,"uploadSize":-1}}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *editRole
+         * 
+         * 入参 {"function":"editRole","role":{"isShow":1,"roleID":5,"name":"管理员2","orderNum":1,"permission":"11111","totalSize":-1,"uploadSize":-1}}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *removerRole
+         * 
+         * 入参 {"function":"removerRole","roleId":"5"}
+         * 出参 {"code":0,"msg":"SUCCESSS"}
+         *
+         *getPermission
+         * 
+         * 入参 {"function":"getPermission","roleId":5,"fileId":1500537350811001112,"userId":12415239841}
+         * 出参 {"result":{"isCreateTeam":1,"isDelete":1,"isDownLoad":1,"isManager":0,"isReName":1,"isRead":1,"isUpLoad":1,"roleID":5,"totalSize":-1,"uploadSize":-1},"code":0,"msg":"SUCCESSS"}
 */
+
 struct JSONParam {
     1: optional byte type
     2: optional string value_str
@@ -1795,8 +1771,6 @@ struct EnORet {
     3: optional OrgUserAndChildNodes nodes
     4: optional list<OrgSearchUserRet> orgSearchUsers;
     5: optional aphead.OrganizationBean  bean;
-    // type 4,5新增了EnORet的6,7 type6,7新增了EnORet的6,7,8 但互不影响
-    12: optional list<aphead.OrganizationBean> orgBeans
 }
 
 
@@ -1852,7 +1826,7 @@ type 类型
    参数：aphead.SignalProtocolAddress oneDevAddr
    返回: code:   0:成功，100:参数错误，11100:内部错误
         value32_1:密钥数量
-   //////////////////////////////////端对端加密end/////////////////////////     
+   //////////////////////////////////端对端加密end/////////////////////////
 
    10.获取潜水者名单
    参数：value64  ==>groupID 群id
@@ -1899,98 +1873,13 @@ type 类型
     3.校验本人是否有生成邀请码的权限
     参数：无
     返回：code为0表示有权限，100001717表示此人没有权限生成邀请码
-         value_str: 新服务器标志-用于区分新老服务器 ==>versionFlag(V5.19.0)
     4.校验邀请码是否有效
     参数：value_str:邀请码     uc:被邀请用户
     返回：code:0邀请码有效；code:100参数错误，100001715邀请码已失效
-    5.根据邀请码获取邀请码信息
+    5.根据邀请码获取邀请人的userID
     参数：value_str:邀请码
     返回：code:0成功   code:100参数错误   11100:服务器内部错误 100001715:邀请码已失效
-         value64:邀请码创建者/绑定人的userId
-         value_byte //即buddySwitch，用户注册后是否加好友;0:加好友，1：不加好友
-         createUserID:邀请码创建者的userId
-         bindUserID:邀请码绑定人的userId
-         createPattern:创建模式（1-自己创建；2-为他人创建）
-    6.根据群邀请码获处理入群逻辑
-    参数：value_str 群邀请码  
-    返回：
-    code:
-    0 成功
-    100 未知错误类型
-    108 邀请码无效
-    307 该群不存在
-    11100  服务异常
-    100011503 该群不允许群主/管理员邀请其他人进群
-    100015001 扫码人已经在群里，示例：InviteCodeResult(code:100015001, message:{"groupId":21265121800})
-    7.　发送新的朋友短信
-　　参数：type　6
-　　      userIDs　接收者的userid,放入一个
-　　　    langType  发送短信的语言
-　　返回值
-　　    code:0成功   code:100参数错误   11100:服务器内部错误
           value64:邀请人的userID
-
-    8. 查询服务器允许注册人数 (getLimitRegisterCount)
-        参数：无
-        返回值
-            code:
-                0:成功   
-                100:参数错误   
-                11100:服务器内部错误
-                100015004:没有该操作类型
-                100015005:没有设置邀请码权限
-                100015006:修改邀请码失败
-                100015007:查询分享列表失败
-            value_str: 允许注册人数相关信息
-
-    9. 设置邀请码接口 (setInviteCode)
-        参数： 
-            setParam ==> InviteSetParam
-        返回值
-            code:
-                0:成功   
-                100:参数错误   
-                11100:服务器内部错误
-                100015004:没有该操作类型
-                100015005:没有设置邀请码权限
-                100015006:修改邀请码失败
-                100015007:查询分享列表失败
-            what: 服务器当前时间 时间戳毫秒
-    10. 用户邀请码分享列表查询接口 (getShareInviteCodeInfo)
-        参数： 
-            shareParam  用户邀请码参数 ==> aphead.InviteCodeShareParam
-        返回值
-            code:
-                0:成功   
-                100:参数错误   
-                11100:服务器内部错误
-                100015004:没有该操作类型
-                100015005:没有设置邀请码权限
-                100015006:修改邀请码失败
-                100015007:查询分享列表失败
-            shareInfo 邀请码列表 ==> list<aphead.InviteCodeShare>
-    11. 保存邀请码图片 (saveInviteCodePic)
-        参数： 
-            value_str  邀请码
-            value_str2 邀请码图片
-        返回值
-            code:
-                0:成功   
-                100:参数错误   
-                11100:服务器内部错误
-    12. 添加邀请码记录 addInviteCodeRecord
-        参数： 
-            value64     userID
-            value_str   邀请码
-            value8      操作类型   operationFlag
-    13. 保存邀请码绑定人 saveInviteCodeBindUserID
-        参数：
-            inviteCodeBindUserParam  保存邀请码绑定人入参
-        返回值
-            code:
-                0:成功   
-                100:参数错误   
-                11100:服务器内部错误
 */
 struct VerifyCodeParam {
     1: optional byte type
@@ -1999,13 +1888,6 @@ struct VerifyCodeParam {
     4: optional aphead.InviteCodeParam inviteCodeParam
     5: optional string value_str
     6: optional aphead.UserContact uc
-    7: optional aphead.InviteSetParam setParam
-    8: optional i64 value64
-    9: optional aphead.InviteCodeShareParam shareParam
-    10: optional string value_str2
-    11: optional i64 value64_2
-    12: optional byte value8
-    13: optional aphead.InviteCodeBindUserParam inviteCodeBindUserParam
 }
 
 struct VerifyCodeRet {
@@ -2013,54 +1895,11 @@ struct VerifyCodeRet {
     2: optional string what
     3: optional map<i64,string> failRet
     4: optional i64 value64
-    5: optional byte value_byte //即buddySwitch，用户注册后是否加好友;0:加好友，1：不加好友
-    6: optional string extData // 验证码拓展字段
-    7: optional list<aphead.InviteCodeShare> shareInfo
-    8: optional string value_str
-    9: optional i64 createUserID // 邀请码创建者的userId
-    10: optional i64 bindUserID  // 邀请码绑定人的userId
-    11: optional byte createPattern // 创建模式（1-自己创建；2-为他人创建）
-}
-////
-/*
-type：类型
-    1.清除缓存,
-    参数：value_str1　缓存key
-    返回：code
-    2.设置缓存
-    参数：
-    	value_str1  缓存key
-    	value_str2  缓存value
-    	value_str3  session
-    返回：code
-    3.获取缓存
-    参数：value_str1　 缓存key
-    返回：code 
-    	 value  缓存value
-    4.根据 roomId获取token
-    参数:value_str1 表示roomId
-    返回值code 0 表示成功
-    value 表示返回的token
-*/
-
-struct CacheParam {
-    1: optional byte type
-    2: optional string value_str1
-    3: optional binary value_str2
-    4: optional string value_str3
 }
 
-struct CacheRet {
-    1: i32 code
-    2: optional string what
-    3: optional binary value 
-}
-
-
-
 /*
 type 类型
-    1.
+    1.查询用户的群时间戳
     参数：value64_1==>groupID 上一次查询结果集中最大的群ID（第一次为0）
           value64_2==>timestamp 客户端传过来用作比对的时间戳（第一次为0）
           value16==>size 每次拉取群的个数
@@ -2074,10 +1913,6 @@ type 类型
     参数：value64_1==>groupID
     返回：code:　100011018:成功，11100:内部错误，100011013:服务异常，100011019:未查询到结果
         groupSetting 客户端对该群的设置信息
-    4.根据群名片规则修改全部群成员群名片 (updateAllGroupMemberName)
-        场景：修改/设置 群名片规则，群成员更新群名片规则显示
-        传入参数： value64_1 ==> groupID
-        返回：code: 0:成功 100:未知错误;  100011504:群名片规则未开启或未配置
 */
 
 struct GroupMemParam {
@@ -2095,6 +1930,63 @@ struct GroupMemRet {
     4: optional aphead.UserGroupSettingsExtend groupSetting
 }
 
+/*
+type 类型
+    其他错误码
+        100022001;//参数错误
+        100022002;//收藏用户id不能为空
+        100022003;//保存文件到云盘失败
+        100022004;//保存数据失败
+        100022005;//删除数据失败
+        100022006;//该收藏信息不存在
+        100022007;//收藏id不能为空
+
+    1.新增收藏信息
+    参数：aphead.CollectionBean bean 收藏信息
+    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
+    2.删除收藏信息
+    参数：value64_1 用户uid; value64_2 收藏ID;
+    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
+    3.获取收藏信息
+    参数：value64_1 用户uid; value64_2 收藏ID;
+    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
+    bean: 收藏信息
+    4.分页查询收藏列表信息
+    参数：params:
+     		key=messageType,根据消息类型查询
+     		key=message,根据消息内容查询
+     		key=fileName,根据文件名称查询
+    		key=startTime,创建开始时间
+     		key=endTime,创建结束时间
+     	value16_1:每页的条数
+     	value16_2:当前页码
+    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
+    aphead.CollectionBeanStruct beans　收藏列表信息
+    5.批量删除收藏信息
+    参数：value64_1 用户uid; list_i64 收藏ID集合
+    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
+    6.编辑文本类型收藏内容
+    参数：aphead.CollectionBean bean，必填collectionID，collectUserId，messageType和message
+    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
+*/
+struct CollectionParam {
+	1: optional byte type
+	2: optional i16 value16_1
+	3: optional i16 value16_2
+	4: optional i64 value64_1
+	5: optional i64 value64_2
+	6: optional map<string,string> params
+	7: optional aphead.CollectionBean bean;
+	8: optional list<i64> list_i64;
+}
+
+struct CollectionRet {
+    1: i32 code
+    2: optional string what
+    3: optional aphead.OperateCollectionResult bean
+    4: optional aphead.CollectionBeanStruct beans
+}
+
 /*
 type 类型
     1.提交意见反馈
@@ -2124,7 +2016,7 @@ type 类型
 struct FeedBackParam {
 	1: optional byte type
 	2: optional aphead.Feedback fb
-        3: optional map<string ,string> map_strstr
+    3: optional map<string ,string> map_strstr
 }
 
 struct FeedBackRet {
@@ -2133,6 +2025,36 @@ struct FeedBackRet {
 	3: optional list<aphead.SystemHelp> helpRlt
 }
 
+/*
+type：类型
+    1.清除缓存,
+    参数：value_str1　缓存key
+    返回：code
+    2.设置缓存
+    参数：
+    	value_str1  缓存key
+    	value_str2  缓存value
+    	value_str3  session
+    返回：code
+    3.获取缓存
+    参数：value_str1　 缓存key
+    返回：code 
+    	 value  缓存value
+*/
+
+struct CacheParam {
+    1: optional byte type
+    2: optional string value_str1
+    3: optional string value_str2
+    4: optional string value_str3
+}
+
+struct CacheRet {
+    1: i32 code
+    2: optional string what
+    3: optional string value 
+}
+
 /*
 type 类型
     1.好友申请请求
@@ -2204,19 +2126,26 @@ struct VerifyMessageParam {
 }
 
 struct VerifyMessageRet {
-        1: i32 code
-        2: optional string what
+	1: i32 code
+	2: optional string what
     3: optional i64 value64
     4: optional i16 value16
     5: optional map<i16,i64> groupPageTimestampMap
-    6: optional list<aphead.TinyUserBean> inviteVerifyUserList;
-    7: optional list<aphead.TinyUserBean> inviteNotAllowUserList;
-    8: optional list<aphead.TinyUserBean> inviteAddUserList;
-    9: optional list<aphead.TinyUserBean> inviteAdminVerifyUserList;
 }
+
+// 如果服务器的游标与客户端的游标相同, 则 3/4 不返回值
+// ts 主要是分页返回敏感词, 比如客户端 游标为100 服务器游标为10000,
+// 服务器有可能需要分 99 次给客户端返回
+struct BadWordRet {
+    1: i32 code
+    2: optional string what
+    3: optional i64 ts     // 当前返回给客户端的敏感词列表中最大的 游标(时间戳)
+    4: optional list<aphead.Words> words // 敏感词
+}
+
 //登录和注册获取验证码
 struct GetVerifyCodeParam {
-    1: byte operType;  //1.注册，2.登录
+    1: byte operType;  //1.注册，2.登录 3.更换设备获取验证码
     2: string user;    //手机号
     3: optional i64 sdkid; // 默认为0
     4: optional i32 tzone         // 时区
@@ -2234,199 +2163,25 @@ struct GetVerifyCodeResult {
     4: optional i64 inviteCodeID
 }
 
-// 如果服务器的游标与客户端的游标相同, 则 3/4 不返回值
-// ts 主要是分页返回敏感词, 比如客户端 游标为100 服务器游标为10000,
-// 服务器有可能需要分 99 次给客户端返回
-struct BadWordRet {
+/*
+type 类型
+    1.根据账户类型替换账户
+    参数：userContact 
+    返回：code: 0表示替换成功，否则替换失败
+    2.判定用户是否在SDK白名单中
+    参数：无
+    返回：code   
+         100004501				是sdk白名单用户
+         100004502				不是sdk白名单用户
+*/
+struct UserServiceParam {
+    1: optional byte type
+    2: optional aphead.UserContact userContact
+}
+
+struct UserServiceRet {
     1: i32 code
     2: optional string what
-    3: optional i64 ts     // 当前返回给客户端的敏感词列表中最大的 游标(时间戳)
-    4: optional list<aphead.Words> words // 敏感词
-}
-
-/*
-type 类型
-    其他错误码
-        100022001;//参数错误
-        100022002;//收藏用户id不能为空
-        100022003;//保存文件到云盘失败
-        100022004;//保存数据失败
-        100022005;//删除数据失败
-        100022006;//该收藏信息不存在
-        100022007;//收藏id不能为空
-
-    1.新增收藏信息
-    参数：aphead.CollectionBean bean 收藏信息
-    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
-    2.删除收藏信息
-    参数：value64_1 用户uid; value64_2 收藏ID;
-    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
-    3.获取收藏信息
-    参数：value64_1 用户uid; value64_2 收藏ID;
-    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
-    bean: 收藏信息
-    4.分页查询收藏列表信息
-    参数：params:
-     		key=messageType,根据消息类型查询
-     		key=message,根据消息内容查询
-     		key=fileName,根据文件名称查询
-    		key=startTime,创建开始时间
-     		key=endTime,创建结束时间
-     	value16_1:每页的条数
-     	value16_2:当前页码
-    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
-    aphead.CollectionBeanStruct beans　收藏列表信息
-    5.批量删除收藏信息
-    参数：value64_1 用户uid; list_i64 收藏ID集合
-    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
-    6.编辑文本类型收藏内容
-    参数：aphead.CollectionBean bean，必填collectionID，collectUserId，messageType和message
-    返回：code:　0:成功，100:参数错误，11100:内部错误,其他：见上面
-*/
-struct CollectionParam {
-	1: optional byte type
-	2: optional i16 value16_1
-	3: optional i16 value16_2
-	4: optional i64 value64_1
-	5: optional i64 value64_2
-	6: optional map<string,string> params
-	7: optional aphead.CollectionBean bean;
-	8: optional list<i64> list_i64;
-}
-
-struct CollectionRet {
-    1: i32 code
-    2: optional string what
-    3: optional aphead.OperateCollectionResult bean
-    4: optional aphead.CollectionBeanStruct beans
-}
-
-
-/*
-type 类型
-    1.添加群公告
-        场景：客户端群管理员/群主添加群公告
-        传入参数：aphead.GroupAnnouncement groupAnnounce
-        返回：code:
-              100011011:成功  100011012:失败   100011013:服务异常  100011014:非群管理员、群主无权操作
-    2.删除单个群公告
-        场景：客户端群管理员/群主删除群公告
-        传入参数：value64_1   群公告ID
-                 value64_2   群ID
-        返回：code:
-              100011011:成功  100011012:失败   100011013:服务异常  100011014:非群管理员、群主无权操作
-    3.校验群公告是否存在
-        场景：客户端群成员查看群公告消息判断公告是否还存在
-        传入参数：value64_1   群公告ID
-                 value64_2   群ID
-        返回：code:
-              100011013:服务异常  100011015:非群成员   100011016:公告存在    100011017:公告不存在
-    4.分页获取群公告列表
-        场景：客户端群成员查看群公告列表信息
-        传入参数：aphead.GroupAnnouncementParam announceQueryParam
-        返回：code:
-              100011011:成功 100011013:服务异常  100011015:非群成员
-              list<aphead.GroupAnnouncement> announceList 群公告列表
-    5.设置群禁言
-        场景：客户端群管理员/群主设置群禁言
-        传入参数：aphead.GroupForbid groupForbid
-        返回：code:
-              0: 成功 100011022:没有权限禁言群/群成员 100011023:禁言对象不是群成员
-*/
-struct GroupParam {
-    1: optional byte type
-    2: optional i64 value64_1
-    3: optional i64 value64_2
-    4: optional aphead.GroupAnnouncement groupAnnounce
-    5: optional aphead.GroupAnnouncementParam announceQueryParam
-    6: optional aphead.GroupForbid groupForbid
-}
-
-struct GroupRet {
-    1: i32 code
-    2: optional string what
-    3: optional list<aphead.GroupAnnouncement> announceList
-}
-
-/*
-type 类型
-    1.根据账户类型替换账户
-    参数：userContact
-    返回：code: 0表示替换成功，否则替换失败
-    2.判定用户是否在SDK白名单中
-    参数：无
-    返回：code
-         100004501				是sdk白名单用户
-         100004502				不是sdk白名单用户
-    3.根据userID和策略类型获取该用户的策略 (getUserTagStrategy)
-    参数:
-        value64_1  要查询的用户id
-        type_2   策略类型
-    返回：userTagStrategy 类型 aphead.UserTagStrategy
-    4.用户账号注销校验/密码校验
-    参数:
-        authenticationBean 类型:aphead.UserAuthenticationBean
-    返回:
-        code 结果码
-        100004500 成功，通过
-        100004520 接口异常、失败
-        100004521 用户不存在
-        100004522 密码错误
-        100004523 类型不合法
-        100004527 禁止注销/禁止申请注销
-        100004528 注销(type=1)/申请注销(type=2)对应注销配置项不匹配
-        100004530 用户被锁定
-        message 结果码说明
-        value_str1 验证成功返回验证码,原先为authenticationCode（密码校验不返回）
-    5.用户账号注销
-    参数:
-        value_str1 注销用户认证码,原先为authenticationCode
-    返回:
-        code 结果码
-        100004500 成功，通过
-        100004520 接口异常、失败
-        100004521 用户不存在
-        100004524 注销验证码验证失败
-        message 结果信息
-    6.查询注销状态
-    参数：无
-    返回：
-      code结果码
-      100004525  不存在待审核注销申请
-      100004526  存在待审核注销申请
-    7.取消注销申请
-    参数：无
-    返回：
-      code结果码
-      100004500  成功，通过
-      100004525  不存在待审核注销申请
-    8.根据用户id查询管理员身份信息接口
-    参数:
-        无
-    返回:
-        code 结果码 100004500成功 100004521 失败
-        message ,原先为msg
-        value_str1 即result：Json字符串格式返回结果{“adminName”:”陈鹏”,”adminAccount”:”chenpeng”,”superAdmin”:false}
-                            adminName管理员名称
-                            adminAccount管理员账号
-                            superAdmin超管标识
-
-*/
-struct UserServiceParam {
-    1: optional byte type
-    2: optional aphead.UserContact userContact
-    3: optional i64 value64_1
-    4: optional byte type_2
-    5: optional aphead.UserAuthenticationBean authenticationBean
-    6: optional string value_str1
-}
-
-struct UserServiceRet {
-    1: i32 code
-    2: optional string what
-    3: optional aphead.UserTagStrategy userTagStrategy
-    4: optional string message
-    5: optional string value_str1
 }
 
 /////////////////////////////////////////
@@ -2483,6 +2238,28 @@ struct OauthRet {
     4: optional string value_str
 }
 
+
+/*
+type 类型
+    1,保存群文件
+        传入参数：groupFile
+        返回：code:
+            0:成功
+            343:用户ID无效/用户不存在
+            307:该群不存在
+            309:该用户不是群成员
+            
+*/
+struct GroupFileParam {
+    1: optional byte type
+    2: optional aphead.GroupFile groupFile
+}
+
+struct GroupFileRet {
+    1: i32 code
+    2: optional string what
+}
+
 /**
  * 二维码扫描结果集
  * 0 扫码/登录成功
@@ -2500,48 +2277,153 @@ struct QrCodeRet {
 }
 
 /*
-type 类型 (type 2~5 被双因子项目占用,6以后的参数都需要markSign 来获取sdkId)
-    1.第三方登录的前置步骤 (doLoginPre)
+type 类型
+    1.添加群公告
+        场景：客户端群管理员/群主添加群公告
+        传入参数：aphead.GroupAnnouncement groupAnnounce
+        返回：code:
+              100011011:成功  100011012:失败   100011013:服务异常  100011014:非群管理员、群主无权操作
+    2.删除单个群公告
+        场景：客户端群管理员/群主删除群公告
+        传入参数：value64_1   群公告ID
+                 value64_2   群ID
+        返回：code:
+              100011011:成功  100011012:失败   100011013:服务异常  100011014:非群管理员、群主无权操作
+    3.校验群公告是否存在
+        场景：客户端群成员查看群公告消息判断公告是否还存在
+        传入参数：value64_1   群公告ID
+                 value64_2   群ID
+        返回：code:
+              100011013:服务异常  100011015:非群成员   100011016:公告存在    100011017:公告不存在
+    4.分页获取群公告列表
+        场景：客户端群成员查看群公告列表信息
+        传入参数：aphead.GroupAnnouncementParam announceQueryParam
+        返回：code:
+              100011011:成功 100011013:服务异常  100011015:非群成员
+              list<aphead.GroupAnnouncement> announceList 群公告列表
+    5.设置群禁言
+        场景：客户端群管理员/群主设置群禁言
+        传入参数：aphead.GroupForbid groupForbid
+        返回：code:
+              0: 成功 100011022:没有权限禁言群/群成员 100011023:禁言对象不是群成员
+*/
+struct GroupParam {
+    1: optional byte type
+    2: optional i64 value64_1
+    3: optional i64 value64_2
+    4: optional aphead.GroupAnnouncement groupAnnounce
+    5: optional aphead.GroupAnnouncementParam announceQueryParam
+    6: optional aphead.GroupForbid groupForbid
+}
+
+struct GroupRet {
+    1: i32 code
+    2: optional string what
+    3: optional list<aphead.GroupAnnouncement> announceList
+}
+
+/*
+type 类型
+    1.判断当前用户是否为客服(isCustomer)
+        场景：客户端登录时触发
+        传入参数：无
+        返回：code:
+                100023002:成功  11100:服务异常 100:参数错误
+              value_bool:
+                true为是，false为否              
+    2.获取客服正在服务的用户列表(getUserByAppIdAndCustomId)
+        场景：客户端点击公众号时触发
+        传入参数：value64_1   公众号appID
+        返回：code:
+                100023002:成功  11100:服务异常 100:参数错误
+              smallUserBeans:
+                用户列表               
+    3.获取客户池列表(getCustomerPoolByAppID)
+        场景：客户端点击客户池时触发
+        传入参数：value64_1   公众号appID
+        返回：code:
+                100023002:成功  11100:服务异常 100:参数错误
+              customerPoolBeans:
+                等待客户的集合
+    4.关闭会话(closeConversation)
+        场景：客户端点击关闭会话时触发
+        传入参数：value64_1:客服ID(非客服用户的userID) value64_2:客户的userID
+        返回：code:
+              100023002操作成功 100023008当前客服未接待该用户 100023009客服不存在 100023001服务异常 11100:java服务异常 100:参数错误
+    5.接入客户(accessCustom)
+        场景：客户端点击客户池接入客户时触发
+        传入参数：value64_1:客服ID(非客服用户的userID)  value64_2:客户的userID
+        返回：code:
+              100023002:成功 100023003:操作失败 11100:服务异常 100:参数错误 100023010:客服与客户是同一人，不能接入
+    6.获取最后一条消息(getLastMessage)
+        场景：客户端点击新接入的客户时触发
+        传入参数：value64_1:客服ID(非客服用户的userID) value64_2:客户的userID
+        返回：code:
+                100023002:成功  11100:服务异常 100:参数错误
+              messageBean:
+                最后一条消息
+    7.获取客户池大小(getCustomPoolCount)
+        传入参数：value64_1   公众号appID
+        返回：code:
+                100023002:成功  11100:服务异常 100:参数错误
+              value64:
+                客户池数量
+    8.修改客服信息(updateCustomerService)
+        场景: 用于修改客服信息
+        传入参数：value64_1 公众号appID
+                value64_2 客服id（SmallEntAppInfo中的CSID字段）
+                value8    客服接待状态 1:客服在线（可接待用户），2:客服离线（不可接待用户）
+                value32    当前最大可接待数
+        返回：code:
+                100023002:成功 100023003:操作失败 11100:服务异常 100:参数错误
+    9.获取客服公众号信息集合(getAppListByUserID)
+        场景: 客户端 客服展示列表
+        传入参数：无
+        返回：code:
+                100023002:成功  11100:服务异常 100:参数错误
+             smallApps:
+                客服公众号信息集合
+    10.查询单个客服信息(getCustomerServiceById)
+        场景: 公众服务平台客服管理
+        传入参数：value64_1 客服id(CSID)
+        返回：code:
+                100023002:成功  11100:服务异常 100:参数错误
+             AppCustomerInfo:
+		客服信息
+*/
+struct CustomerParam {
+    1: optional byte type
+    2: optional i64 value64_1
+    3: optional i64 value64_2
+    4: optional byte value8
+    5: optional i32 value32
+}
+
+struct CustomerRet {
+    1: i32 code
+    2: optional string what
+    3: optional bool value_bool
+    4: optional i64 value64
+    5: optional list<aphead.SmallUserBean> smallUserBeans
+    6: optional list<aphead.CustomerPoolBean> customerPoolBeans
+    7: optional aphead.MessageBean messageBean
+    8: optional list<aphead.SmallEntAppInfo> smallApps
+    9: optional aphead.AppCustomerServiceInfo AppCustomerInfo
+}
+
+/*
+type 类型
+    1.第三方登录的前置步骤
     参数: value_str_1 方法名
          value_str_2 透传的json参数
     返回: code:透传的错误码
           what:错误信息
           value_str: 返回的json结果
-    6.获取二维码信息 (getPCLoginQrCode)
-    参数: value_str_1 服务器elogo
-         value_str_2 PC端登录信息
-         markSign markSign
-    返回: code:透传的错误码
-          what:错误信息
-          value_str: 二维码数据（JSON）
-    7.获取二维码登录结果 (getPCLoginQrCodeStatus)
-    参数: value_str_1 二维码唯一id
-          value_str_2 二维码唯一id加密值
-          markSign markSign
-    返回: code:透传的错误码
-          what:错误信息
-          value_str: 二维码数据（JSON）
-    8.校验最后一次PC扫码登录设备接口 (checkRecentQcLoginDevice)
-    参数: value64_1 用户id
-          value_str_1 macCode
-          markSign markSign
-    返回: code:透传的错误码
-          what:错误信息
-    9.PC端快速登录接口 (pcQuickLogin)
-    参数: value64_1 用户id
-          value_str_1 PC端登录信息
-          markSign markSign
-    返回: code:透传的错误码
-          what:错误信息
-          value_str: 用户信息数据（JSON）
-
 */
 struct BeforeLoginParam {
     1: optional byte type
     2: optional string value_str_1
     3: optional string value_str_2
-    4: optional string markSign
-    5: optional i64 value64_1
 }
 
 struct BeforeLoginRet {
@@ -2555,9 +2437,9 @@ type 类型
     1.设备下线
     参数：value8 要下线的设备类型 1：PC；2：手机；3：pad；4：网页
     返回：code:
-                0   成功
-                100 参数错误
-                100008003 失败
+    		0   成功
+          	100 参数错误
+          	100008003 失败
           what:错误信息
    2.用户信息字段验证
    参数：accountType 用户账号信息
@@ -2575,27 +2457,6 @@ type 类型
    返回：code:
          100008007    删除登录设备列表失败
          100008008    删除登录设备列表成功
-   5.移动端扫PC端登录二维码接口 (scanPCLoginQrCode)
-   参数: value_str 服务器elogo
-        value_str2 二维码唯一id
-   返回：code: 透传的错误码
-        what:错误信息
-        value_str: 二维码数据（JSON）
-   6.移动端扫PC端登录二维码确认接口 (scanPCLoginQrCodeConfirm)
-   参数: value_str 二维码唯一id
-        value8 是否确认登录(1: 确认登录 2:取消登录)
-   返回：code: 透传的错误码
-        what:错误信息
-        value_str: 二维码数据（JSON）
-    7.根据用户ID集合查询用户的设备信息,豆豆版本
-    参数：userIDs 用户的userID集合
-    返回：code:错误码
-             100008023 成功
-             100008024 查询人数超过500人
-             100008025 查询异常
-             100008026 用户ID集合为空
-         what：结果信息
-         resultLoginRecord：返回结果集
 */
 struct LoginSParam {
 	1: optional byte type
@@ -2603,17 +2464,14 @@ struct LoginSParam {
 	3: optional aphead.AccountType accountType
 	4: optional string value_str
     5: optional list<string> macAddrs
-    6: optional string value_str2
-    7: optional list<i64> userIDs
 }
 
 struct LoginSRet {
-    1: i32 code
-    2: string what
-    3: optional list<aphead.LoginRecord> loginRecordList
-    4: optional string value_str
-    5: optional map<i64, list<aphead.LoginClientRecord> > resultLoginRecord
+	1: i32 code
+	2: string what
+        3: optional list<aphead.LoginRecord> loginRecordList
 }
+
 /*
 type 类型
     1 添加/编辑会话设置接口
@@ -2625,15 +2483,16 @@ type 类型
                 100009502 操作失败
          what:错误信息
     2 获取会话设置
-    参数：
+    参数：value64_1：userID
     返回：sessionList 会话列表
 	 code:
           	100 参数错误
 		11100 服务异常
 		100009501 操作成功 
     
+ 
     3 获取用户的会话列表
-    参数：
+    参数：value64_1：userID
     返回：sessionList 会话列表
 	 code:
           	100 参数错误
@@ -2653,155 +2512,12 @@ struct ChatRet {
         3: optional list<aphead.SessionInfo> sessionList
 }
 
-struct SecRet {
-    1: i32 code // 错误码 0：成功 11100 服务异常
-    2: string what // 错误描述
-    3: optional i64 ts     // 当前返回给客户端的密级中的涉密关键字列表中最大的 游标(时间戳)
-    4: optional list<aphead.SecKeyWord> secList// 涉密关键字列表
-    5: optional i64 maxTs // 最大涉密关键字id
-}
-
-/////////////////////////////////////////////
-/*
-type 类型
-        1, 单个查询表情
-	   传入参数：value_str_1	# 表情文件的md5Code
-	   返回：
-		code:　0:成功，100:参数错误，11100:内部错误
-		listEmotion:  list<aphead.Emoticon> listEmotion
-	2,单个查询表情包
-	   传入参数：value_str_1	# 表情包文件的md5Code
-	   返回：
-		code:　0:成功，100:参数错误，11100:内部错误
-		emotPkg: aphead.EmoticonPackage
-		
-	3,分页查询表情包
-	   传入参数：page	#填入 pageNum，pageSize
-	   返回：
-		code:　0:成功，100:参数错误，11100:内部错误
-		page:  aphead.EmoticonPackagePage
-	4,添加自定义表情
-	   传入参数 emoticon, currenttimestamp
-	   返回：
-		code:　0:成功，100:参数错误，801:md5Code不正确，802:md5Code文件已存在，11100:内部错误
-		result: aphead.EmoticonOPResult
-	5,删除自定义表情
- 	   传入参数 emoticon, currenttimestamp
-	   返回：
-		code:　0:成功，100:参数错误，801:md5Code不正确，11100:内部错误
-		result: aphead.EmoticonOPResult
-	6,根据表情包标识查询所有表情
- 	   传入参数：value_str_1 	#表情文件的md5Code
-	   返回：
-		code:　0:成功，100:参数错误，11100:内部错误
-		listEmotion: list<aphead.Emoticon>
-	7,查询用户所有自定义表情
-	   返回：
-		code:　0:成功，100:参数错误，11100:内部错误
-		listEmotion: list<aphead.Emoticon>
-    8,根据表情包标签查询相关表情包集合
-       传入参数: value_str_1    #表情包标签
-       返回:
-        code:　0:成功，100:参数错误，11100:内部错误
-        listEmotPkg: list<aphead.EmoticonPackage>
-    9. 根据sha256Hash查询表情
-    	传入参数　value_str_1　表示大图和小图的sha256hash
-    	返回：code　0 成功
-    	　　　listEmotion　返回的表情
-    10. 根据userid和本地表情时间戳,获取表情包的增量信息进行同步
-       type 10 currenttimestamp
-        返回
-        result: aphead.EmoticonOPResult
-    11. 排序表情包
-    	传入参数 emoticonList, currenttimestamp
-    	aphead.EmoticonOPResult
-    	code 0 成功  其他失败
-    12. 批量导入自定义表情
-    	传入参数 emoticonList, currenttimestamp
-    	aphead.EmoticonOPResult
-    	code 0 成功  其他失败
-    13. 批量删除用户收藏的表情包
-    传入参数 emoticonList, currenttimestamp
-	   返回：
-		code:　0:成功，100:参数错误，11100:内部错误
-		result: aphead.EmoticonOPResult
-
-*/
-
-struct EmotParam {
-    1: optional byte type
-    2: optional string value_str_1
-    3: optional aphead.EmoticonPackagePage page
-    4: optional aphead.Emoticon emoticon
-    5: optional list<aphead.Emoticon> emoticonList
-    6: optional i64 currenttimestamp
-}
-
-struct EmotRet {
-    1: i32 code
-    2: optional string what
-    3: optional aphead.EmoticonOPResult result
-    4: optional aphead.EmoticonPackage emotPkg
-    5: optional aphead.EmoticonPackagePage page
-    6: optional list<aphead.Emoticon> listEmotion
-    7: optional list<aphead.EmoticonPackage> listEmotPkg
-}
-
-struct LoginBean {
-  /*账号、邮箱、手机号、QQ号、（湖北公安code）*/
-  1: string loginAccount; 
-  /*1：PC；2：手机；3：pad；4：网页*/
-  2: byte deviceType;   
-  /*接入点IP*/
-  3: string ip;
-  /*接入点端口*/
-  4: i32 port;
-  /*用户类型：1：手机号 2：第三方关联,3：邮箱,4：用户ID,99: SAML认证用户,6：豆豆号,7:使用自定义拓展字段来进行登陆, 8: 第三方授权登录 -1：传用户ID但票验证 100湖北公安auth登录*/
-  5: byte userType;
-  /*mac地址*/
-  6: string macCode;
-  /*设备信息*/
-  7: string deviceInfo;
-  /*-1：离线，1:在线；2:隐身,3:忙碌,4:离开,5:请勿打扰,6:想聊天*/
-  8: byte flag;
-  /* 客户端IP */
-  9: optional string clientIP;
-  /* 是否已验证，true已验证(针对resSign=8|9的时候用) */
-  10: optional bool verified;
-  11: i64 SDKID;
-  /*auth回掉地址*/
-  12:optional string redirectUri;
-  /*设备类型 品牌主要是推送用 0苹果 1 华为 2 google 3 中电科*/
-  13:optional i32 deviceType2;
-  /*密码(华数传媒)*/
-  14:optional string pwd;
-  /*客户端版本号*/
-  15:optional string clientVersion;
-  /*用于传递三方认证所需参数（JSON格式）*/
-  16:optional string thirdAuthParamJson;
-}
-
-/**
- * 用于getUserOnlineByLogin的结果
- */
-struct UserOnlineResult{
-  /*返回码*/
-  1: i32 resultCode;
-  /*返回数据*/
-  2: list<aphead.OnLineUserBean> onlineBeans;
-}
-
-
 /*  interface */
 service APService {
     /// 登陆接口
     /// macAddr,version字段必填
     LoginResult login_im(1: LoginParam param)
 
-    //校验用户/返回用户在线信息
-    UserOnlineResult getUserOnlineByLogin(1: LoginBean lb, 2: string pwd)
-
-
     /// 登陆验证,用于验证码的确认
     /// macaddr 字段必填,切应与login_im保持一致
     GetVerifyResult verifyImageForLogin_im(1: string user, 2: VerifyParam param)
@@ -2844,7 +2560,7 @@ service APService {
 
     /// 获取单个人的信息
     GetUserResult getUser(1: SessionTicket st, 2: i64 userID)
-    
+
     ///根据客户端使用场景获取相应用户资料
     GetUserResult getUserInfo(1: SessionTicket st, 2: UserSence user)
 
@@ -3040,12 +2756,13 @@ service APService {
 
     // 只有code有值
     CommonDataResult viewBurnMessage(1:SessionTicket st, 2:i64 targetID, 3:i64 messageID)
-
+    //TODO删除
     //CommonDataResult reportPluginStatus(1: SessionTicket st, 2: PluginParam param)
 
     /// ios 通知使用
     // 需要设置 token 以及 reveiveType
     // 1 设置成功， 2 设置失败
+    //TODO需要确认
     //CommonDataResult setupReceiveNotice(1: SessionTicket st, 2: IosNoticeInfo info)
 
     // 紧紧需要设置token
@@ -3059,7 +2776,7 @@ service APService {
 
     // 设置IOS token
     // code 有值
-    // 不再使用（2015-12-29），参考qOnlineS
+    // TODO不再使用（2015-12-29），参考qOnlineS
     //CommonDataResult setIosDeviceToken(1:SessionTicket st, 2:string token)
 
     //设置token及appleID,zxq add @2015.12.30
@@ -3093,21 +2810,6 @@ service APService {
     // i64 字段可能有值
     CommonDataResult resetHiddenPWD(1:SessionTicket st, 2:string oldpwd, 3:string newpwd)
 
-    /*
-    延时消息取消/立即发送接口
-    参数：
-        messageID 消息ID
-        type 操作类型1 取消发送 2立即发送
-    返回：
-        code 结果码
-        0 成功
-        100010054 入参不正确
-        100010055 该延时消息不存在
-        100010056 立即发送延时消息失败
-        message 结果码说明
-    */
-    CommonDataResult handleDelayMsgByType(1:SessionTicket st, 2:i64 messageID, 3:byte type);
-
     /// 延迟消息
     // 删除延迟消息
     // code 有值
@@ -3129,18 +2831,18 @@ service APService {
     /// 绑定解绑账号
     // 如果需要短信或者邮箱验证的 请调用这个函数
     // 目前 仅仅 用来绑定 手机跟邮箱会用到
-    // 2016.5.6 废弃！不再使用！绑定接口改为 MultiOperateWithST
+    // TODO 2016.5.6 废弃！不再使用！绑定接口改为 MultiOperateWithST
     //AuthenticationResult authenticationUserInfo(1: SessionTicket st, 2: AuthenticationParam param)
 
     // 如果获取到了验证码请调用下边的
     // code 有值
-    // 2016.5.6 废弃！不再使用！绑定接口改为 MultiOperateWithST
+    // TODO2016.5.6 废弃！不再使用！绑定接口改为 MultiOperateWithST
     //CommonDataResult authenticationVerifyMessage(1: SessionTicket st, 2: AuthenticationServerCode aCode)
 
     // 下面这个函数目前用于
     // 1. 绑定账号 2. 解绑账号
     // i64 可能有值
-    // 2016.5.6 废弃！不再使用！绑定接口改为 MultiOperateWithST
+    // TODO2016.5.6 废弃！不再使用！绑定接口改为 MultiOperateWithST
     //CommonDataResult userAccountOperation(1: SessionTicket st, 2: UserAccountOperate op)
 
 
@@ -3222,10 +2924,11 @@ service APService {
     // 清空黑名单
     CommonDataResult clearBlacklist(1:SessionTicket st);
 
-    /// TODO(2016-3-5) 该接口尚有疑问，暂时继续使用
+    /// TODO需要确认 (2016-3-5) 该接口尚有疑问，暂时继续使用
     // 获取黑名单
     // i64 获取ID列表
     // 2015-8-25 该接口将来会被删除，请使用新的接口 get_list
+    // 2018-6-19 get_list未开发，暂时保留
     CommonListResult getBlacklist(1:SessionTicket st);
 
 
@@ -3251,12 +2954,15 @@ service APService {
     CommonSettingServerResult getUserToTargetSwitch(1:SessionTicket st,2:i64 targetUserId,3:byte modeType );
 
     // 个人资料是否公开设置
-    //switchType: 开关类型
-    //1：生日 2：电话 3：邮件, value: 1：所有人可见 2：仅好友可见 3：仅自己可见，默认1 
-    //4：好友验证方式, value: 1：需要验证信息,2:不允许任何人添加,3:允许任何人添加，默认1 
-    //5：V标(好友，群)提醒模式, value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1 
-    //6：@相关人提醒模式, value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1 
-    //7：全局通知消息内容模式, value: 1:通知详情，2：通知源，隐藏内容 3:完全隐藏，默认2 
+    // 参数:switchType:开关类型 1:生日 2:电话 3:邮件, value:1:所有人可见 2:仅好友可见 3:仅自己可见
+    //switchType:开关类型 4:好友验证方式,value:1:不允许任何人添加,2:需要验证信息,3:允许任何人添加
+    /// 2016-1-28
+    ///switchType: 开关类型 
+    ///1：生日 2：电话 3：邮件, value: 1：所有人可见 2：仅好友可见 3：仅自己可见，默认1 
+    ///4：好友验证方式, value: 1：需要验证信息,2:不允许任何人添加,3:允许任何人添加，默认1 
+    ///5：V标(好友，群)提醒模式, value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1 
+    ///6：@相关人提醒模式, value: 1:表示始终有声音提醒，2：表示始终无声音提醒 3:不始终提醒，默认1 
+    ///7：全局通知消息内容模式, value: 1:通知详情，2：通知源，隐藏内容 3:完全隐藏，默认2 
     
     CommonDataResult setPersonDataSwitch(1:SessionTicket st, 2:aphead.PersonalDataSwitch personalDataSwitch);
 
@@ -3293,12 +2999,13 @@ service APService {
     //设置外部群通知已读
     // 通知ID列表
     CommonDataResult setOutsideGroupNoticeForRead(1: SessionTicket st, 2: list<i64> noticeIDs)
-    // 获取外部企业的文件服务器地址
-    //EnterpriseImagelResult getEnterpriseImages(1: SessionTicket st, 2: list<i64> orgids)
+    // TODO需要删除，获取外部企业的文件服务器地址
+    //TODO 2018-5-26标注删除,兼容SDK暂留
+    EnterpriseImagelResult getEnterpriseImages(1: SessionTicket st, 2: list<i64> orgids)
 
     /// IOS 专用接口
     /// 设置未读消息数量
-    ///@2016.10.28 接口将废弃!!!  使用qIosNS 代替
+    ///TODO@2016.10.28 接口将废弃!!!  使用qIosNS 代替
     //CommonDataResult setIosNotReadMsgCount(1: SessionTicket st, 2: i32 count)
 
     // 获取组织公开配置 根据时间戳同步数据
@@ -3313,8 +3020,7 @@ service APService {
     // 获取某个用户所在组织下可见的子组织和用户
     // 组织是直接子节点，用户是当前组织下用户
     // 参数：enterpriseID 企业ID orgID 用户所在组织ID
-    //get_visible_org_users对应的java接口是getVisibleOrgsUsers，这个接口增加了一个时间戳的参数
-    // 本接口准备废弃，但为了兼容老的客户端，该接口被调用时，在调用java接口时，时间戳传-1000，以告知java服务端是老版本客户端调用
+    //TODO接口将废弃！！标注于20161201。使用qEnOS代替
     //OrgUserAndChildNodes get_visible_org_users(1: SessionTicket st, 2:i64 enterpriseID, 3:i64 orgID);
 
     // 添加黑名单或者白名单
@@ -3323,6 +3029,7 @@ service APService {
     // 从名单中移除
     CommonDataResult batch_remove_list(1:SessionTicket st, 2: SettingList settingList 3: list<i64> targetUserIDList)
     // 获取设置名单
+    //这是未开发的接口，@2018-6-19 by zxq
     //CommonListResult get_list(1:SessionTicket st 2: SettingList settingList);
 
     // 根据条件查询企业用户列表
@@ -3389,7 +3096,7 @@ FuSRet qFuSS(1: SessionTicket st, 2: FuSSParam param)
 // query setting server
 // 1. 获取某个人的所有设置
 
-SettingRet qSettingS(1: SessionTicket st, 2: SettingSParam param)
+///SettingRet qSettingS(1: SessionTicket st, 2: SettingSParam param)
 
 //////////////////////////
 //1.根据查询条件查询出所有的拓展字段信息.
@@ -3441,6 +3148,8 @@ RegURet qRegUS(1:RegUParam param)
 
 ////////////////////////////////
 //1.调用声网服务
+//2.原生朋友圈
+//3.云盘
 JSONRet qJSONS(1: SessionTicket st, 2: JSONParam param)
 
 ////////////////////////////////
@@ -3457,6 +3166,7 @@ RecommendRet qRecommendS(1: SessionTicket st, 2: RecommendParam param)
 
 ////////////////////////////////
 //1.上传消息记数
+//TODO 可能删除
 //MdmRet qMdmS(1: SessionTicket st, 2:MdmParam param)
 
 ////////////////////////////////
@@ -3467,7 +3177,7 @@ EnORet qEnOS(1: SessionTicket st, 2:EnOParam param)
 
 //******************************linkdood内部跳转应用获取授权码****************************
 //返回创建临时Code，调用platform接口存储Code和UserID关系
-//返回临时Code
+//TODO删除返回临时Code
 CommonDataResult getLoginAuthCode(1: SessionTicket st, 2: aphead.LoginAuthParam loginAuthParam)
 
 MsgStoreRet qMsgStoreS(1: SessionTicket st, 2: MsgStoreParam param)
@@ -3478,6 +3188,15 @@ VerifyCodeRet qVerifyCodeS(1: SessionTicket st, 2: VerifyCodeParam param)
 //1.查询有时间戳更新的群聊表信息
 GroupMemRet qGroupMemS(1: SessionTicket st, 2: GroupMemParam param)
 
+//1.新增收藏信息
+//2.删除收藏信息
+//3.获取收藏信息
+//4.分页查询收藏列表信息
+CollectionRet qCollectionS(1: SessionTicket st, 2: CollectionParam param);
+
+//1.提交意见反馈
+FeedBackRet qFeedBackS(1: SessionTicket st, 2: FeedBackParam param);
+
 //1.清除缓存
 //2.设置缓存 
 //3.获取缓存
@@ -3485,34 +3204,20 @@ CacheRet qCacheS(1: SessionTicket st, 2: CacheParam param)
 //消息盒子改造后的接口
 VerifyMessageRet qVerifyMessageS(1: SessionTicket st, 2: VerifyMessageParam param);
 
-//注册和登录获取验证码
-GetVerifyCodeResult getVerifyCode(1: GetVerifyCodeParam param);
 
 // 增量返回敏感词
 BadWordRet getBadWords(1: SessionTicket st, 2: i64 ct);
 
-//1.提交意见反馈
-FeedBackRet qFeedBackS(1: SessionTicket st, 2: FeedBackParam param);
-
-//收藏服务接口
-CollectionRet qCollectionS(1: SessionTicket st, 2: CollectionParam param);
-
-//群公告相关接口
-GroupRet qGroupS(1: SessionTicket st, 2: GroupParam param)
+//注册和登录获取验证码
+GetVerifyCodeResult getVerifyCode(1: GetVerifyCodeParam param);
 
 //1.根据账户类型替换账户
+//2.判定用户是否在SDK白名单中
 UserServiceRet qUserS(1: SessionTicket st, 2: UserServiceParam param);
 
 OauthRet qOauthS(1: SessionTicket st, 2: OauthParam param);
 
-//以后所有不需要参数SessionTicket的接口都走这个
-BeforeLoginRet qBeforeLoginS(1: BeforeLoginParam param);
-
-//1.设备下线
-LoginSRet qLoginS(1: SessionTicket st, 2: LoginSParam param);
-
-//会话列表同步
-ChatRet qChatS(1: SessionTicket st, 2:ChatParam param);
+GroupFileRet qGroupFileS(1: SessionTicket st, 2: GroupFileParam param);
 
 //客户端扫码成功接口
 //@param qId 二维码唯一标识ID userId 用户唯一标识ID serverUrl 服务器地址
@@ -3522,6 +3227,19 @@ QrCodeRet scanSuccess (1: SessionTicket st, 2:i64 qId,3:i64 userId, 4:string ser
 //@param qId 二维码唯一标识ID userId 用户唯一标识ID serverUrl 服务器地址
 QrCodeRet qCodeLogin (1: SessionTicket st, 2:i64 qId,3:i64 userId, 4:string serverUrl);
 
-// 获取密信版本的涉密关键字
-SecRet getSecurityKeyWord(1: SessionTicket st, 2: i64 ct)
+//群公告相关接口
+GroupRet qGroupS(1: SessionTicket st, 2: GroupParam param)
+
+//客户服务相关接口
+CustomerRet qCustomerS(1: SessionTicket st, 2: CustomerParam param)
+
+//以后所有不需要参数SessionTicket的接口都走这个
+BeforeLoginRet qBeforeLoginS(1: BeforeLoginParam param)
+
+//1.设备下线
+LoginSRet qLoginS(1: SessionTicket st, 2: LoginSParam param);
+
+//会话列表同步
+ChatRet qChatS(1: SessionTicket st, 2:ChatParam param);
+
 }