@jiexiaoyin/wecom-api 0.0.2

package/src/modules/security/index.js

@@ -0,0 +1,223 @@
+/**
+ * 安全管理模块
+ * API 章节：七 - 安全管理
+ * 包含：文件防泄漏、设备管理、截屏/录屏管理、高级功能账号管理、操作日志
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Security extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 文件防泄漏 ==========
+
+  /**
+   * 获取文件防泄漏规则列表
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getDlpRules(offset = 0, size = 100) {
+    return this.post('/dlp/rules/list', { offset, limit: size });
+  }
+
+  /**
+   * 获取文件防泄漏规则详情
+   * @param {string} ruleId 规则 ID
+   */
+  async getDlpRuleDetail(ruleId) {
+    return this.post('/dlp/rules/get', { rule_id: ruleId });
+  }
+
+  /**
+   * 创建文件防泄漏规则
+   * @param {object} rule 规则配置
+   */
+  async createDlpRule(rule) {
+    return this.post('/dlp/rules/add', rule);
+  }
+
+  /**
+   * 更新文件防泄漏规则
+   * @param {string} ruleId 规则 ID
+   * @param {object} rule 规则配置
+   */
+  async updateDlpRule(ruleId, rule) {
+    return this.post('/dlp/rules/update', { rule_id: ruleId, ...rule });
+  }
+
+  /**
+   * 删除文件防泄漏规则
+   * @param {string} ruleId 规则 ID
+   */
+  async deleteDlpRule(ruleId) {
+    return this.post('/dlp/rules/del', { rule_id: ruleId });
+  }
+
+  // ========== 设备管理 ==========
+
+  /**
+   * 获取设备列表
+   * @param {string} deviceId 设备 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getDeviceList(deviceId = '', offset = 0, size = 100) {
+    return this.post('/device/list', {
+      device_id: deviceId,
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取设备详情
+   * @param {string} deviceId 设备 ID
+   */
+  async getDeviceDetail(deviceId) {
+    return this.post('/device/get', { device_id: deviceId });
+  }
+
+  /**
+   * 绑定设备
+   * @param {string} deviceId 设备 ID
+   * @param {string} userId 成员 ID
+   */
+  async bindDevice(deviceId, userId) {
+    return this.post('/device/bind', { device_id: deviceId, userid: userId });
+  }
+
+  /**
+   * 解绑设备
+   * @param {string} deviceId 设备 ID
+   */
+  async unbindDevice(deviceId) {
+    return this.post('/device/unbind', { device_id: deviceId });
+  }
+
+  /**
+   * 获取设备使用记录
+   * @param {string} deviceId 设备 ID
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   */
+  async getDeviceLog(deviceId, startTime, endTime) {
+    return this.post('/device/log', {
+      device_id: deviceId,
+      start_time: startTime,
+      end_time: endTime
+    });
+  }
+
+  // ========== 截屏/录屏管理 ==========
+
+  /**
+   * 获取截屏/录屏管理规则
+   */
+  async getScreenCaptureRule() {
+    return this.post('/device/screen_capture/get', {});
+  }
+
+  /**
+   * 设置截屏/录屏管理规则
+   * @param {number} status 状态: 0-关闭 1-开启
+   * @param {string} allowUsers 允许截屏的成员列表
+   * @param {string} denyUsers 禁止截屏的成员列表
+   */
+  async setScreenCaptureRule(status, allowUsers = '', denyUsers = '') {
+    return this.post('/device/screen_capture/set', {
+      status,
+      allow_users: allowUsers,
+      deny_users: denyUsers
+    });
+  }
+
+  // ========== 高级功能账号管理 ==========
+
+  /**
+   * 分配高级功能账号
+   * @param {string} userId 成员 ID
+   * @param {string} type 高级功能类型: exmail, wecom, file, yzp
+   */
+  async assignAdvancedAccount(userId, type) {
+    return this.post('/security/assign_advanced_account', {
+      userid: userId,
+      type
+    });
+  }
+
+  /**
+   * 取消高级功能账号
+   * @param {string} userId 成员 ID
+   * @param {string} type 高级功能类型
+   */
+  async cancelAdvancedAccount(userId, type) {
+    return this.post('/security/cancel_advanced_account', {
+      userid: userId,
+      type
+    });
+  }
+
+  /**
+   * 获取高级功能账号列表
+   * @param {string} type 高级功能类型
+   */
+  async getAdvancedAccountList(type) {
+    return this.post('/security/list_advanced_account', { type });
+  }
+
+  // ========== 操作日志 ==========
+
+  /**
+   * 获取成员操作记录
+   * @param {string} userId 成员 ID
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getMemberOperationLog(userId, startTime, endTime, offset = 0, size = 100) {
+    return this.post('/security/get_member_operation_log', {
+      userid: userId,
+      start_time: startTime,
+      end_time: endTime,
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取管理端操作日志
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} operUserId 操作人 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getAdminOperationLog(startTime, endTime, operUserId = '', offset = 0, size = 100) {
+    return this.post('/security/get_admin_operation_log', {
+      start_time: startTime,
+      end_time: endTime,
+      oper_userid: operUserId,
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取企业微信域名 IP 信息
+   */
+  async getDomainIpList() {
+    return this.post('/security/get_domain_ip_list', {});
+  }
+
+  /**
+   * 获取回调 IP 段信息
+   */
+  async getCallbackIpList() {
+    return this.post('/security/get_callback_ip_list', {});
+  }
+}
+
+module.exports = Security;

package/src/modules/sensitive/index.js

@@ -0,0 +1,170 @@
+/**
+ * 敏感词管理模块
+ * API 章节：十三 - 聊天敏感词
+ * 包含：敏感词管理、敏感行为管理
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Sensitive extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 敏感词管理 ==========
+
+  /**
+   * 获取敏感词列表
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getSensitiveWordList(offset = 0, size = 100) {
+    return this.post('/externalcontact/get_sensitive_word_list', {
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取敏感词详情
+   * @param {string} wordId 敏感词 ID
+   */
+  async getSensitiveWordDetail(wordId) {
+    return this.post('/externalcontact/get_sensitive_word', {
+      word_id: wordId
+    });
+  }
+
+  /**
+   * 添加敏感词
+   * @param {string} word 敏感词
+   * @param {string} wordType 敏感词类型
+   * @param {string} ruleId 规则 ID
+   */
+  async addSensitiveWord(word, wordType = 'keyword', ruleId = '') {
+    return this.post('/externalcontact/add_sensitive_word', {
+      word,
+      word_type: wordType,
+      rule_id: ruleId
+    });
+  }
+
+  /**
+   * 编辑敏感词
+   * @param {string} wordId 敏感词 ID
+   * @param {string} word 敏感词
+   */
+  async updateSensitiveWord(wordId, word) {
+    return this.post('/externalcontact/update_sensitive_word', {
+      word_id: wordId,
+      word
+    });
+  }
+
+  /**
+   * 删除敏感词
+   * @param {string} wordId 敏感词 ID
+   */
+  async deleteSensitiveWord(wordId) {
+    return this.post('/externalcontact/del_sensitive_word', {
+      word_id: wordId
+    });
+  }
+
+  // ========== 敏感词规则管理 ==========
+
+  /**
+   * 获取敏感词规则列表
+   */
+  async getSensitiveRuleList() {
+    return this.post('/externalcontact/get_sensitive_rule_list', {});
+  }
+
+  /**
+   * 获取敏感词规则详情
+   * @param {string} ruleId 规则 ID
+   */
+  async getSensitiveRuleDetail(ruleId) {
+    return this.post('/externalcontact/get_sensitive_rule', {
+      rule_id: ruleId
+    });
+  }
+
+  /**
+   * 添加敏感词规则
+   * @param {object} rule 规则配置
+   */
+  async addSensitiveRule(rule) {
+    return this.post('/externalcontact/add_sensitive_rule', rule);
+  }
+
+  /**
+   * 编辑敏感词规则
+   * @param {string} ruleId 规则 ID
+   * @param {object} rule 规则配置
+   */
+  async updateSensitiveRule(ruleId, rule) {
+    return this.post('/externalcontact/update_sensitive_rule', {
+      rule_id: ruleId,
+      ...rule
+    });
+  }
+
+  /**
+   * 删除敏感词规则
+   * @param {string} ruleId 规则 ID
+   */
+  async deleteSensitiveRule(ruleId) {
+    return this.post('/externalcontact/del_sensitive_rule', {
+      rule_id: ruleId
+    });
+  }
+
+  // ========== 敏感操作管理 ==========
+
+  /**
+   * 获取成员敏感行为列表
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} userId 成员 ID
+   * @param {string} type 行为类型
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getSensitiveActionList(startTime, endTime, userId = '', type = '', offset = 0, size = 100) {
+    return this.post('/externalcontact/get_sensitive_action_list', {
+      start_time: startTime,
+      end_time: endTime,
+      userid: userId,
+      type,
+      offset,
+      limit: size
+    });
+  }
+
+  // ========== 敏感成员配置 ==========
+
+  /**
+   * 获取使用敏感词的成员列表
+   * @param {string} wordId 敏感词 ID
+   */
+  async getSensitiveWordUsers(wordId) {
+    return this.post('/externalcontact/get_sensitive_word_users', {
+      word_id: wordId
+    });
+  }
+
+  /**
+   * 配置敏感词成员例外
+   * @param {string} wordId 敏感词 ID
+   * @param {string[]} userIds 例外成员 ID
+   */
+  async setSensitiveWordExusers(wordId, userIds) {
+    return this.post('/externalcontact/set_sensitive_word_exusers', {
+      word_id: wordId,
+      user_ids: userIds
+    });
+  }
+}
+
+module.exports = Sensitive;

package/src/modules/thirdparty/index.js

@@ -0,0 +1,145 @@
+/**
+ * 企业互联模块
+ * API 章节：五 - 企业互联
+ * 包含：获取下级企业 token、小程序 session 等
+ */
+
+const WeComSDK = require('../../sdk');
+
+class ThirdParty extends WeComSDK {
+  constructor(config) {
+    super(config);
+    this.providerSecret = config.providerSecret || '';
+  }
+
+  // ========== 企业互联基础 ==========
+
+  /**
+   * 获取下级/下游企业的 access_token
+   * @param {string} corpId 下级企业 ID
+   * @param {string} permanentCode 永久授权码
+   */
+  async getSubCorpToken(corpId, permanentCode) {
+    return this.post('/thirdparty/get_sub_corp_token', {
+      corpid: corpId,
+      permanent_code: permanentCode
+    });
+  }
+
+  /**
+   * 获取下级企业授权码
+   * @param {string} authCode 授权 code
+   */
+  async getPermanentCode(authCode) {
+    return this.post('/thirdparty/get_permanent_code', { auth_code: authCode });
+  }
+
+  /**
+   * 获取下级企业授权信息
+   * @param {string} corpId 下级企业 ID
+   */
+  async getCorpInfo(corpId) {
+    return this.post('/thirdparty/get_corp_info', { corpid: corpId });
+  }
+
+  /**
+   * 获取下级企业列表
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getCorpList(offset = 0, size = 100) {
+    return this.post('/thirdparty/get_corp_list', { offset, limit: size });
+  }
+
+  /**
+   * 获取下级/下游企业小程序 session
+   * @param {string} userId 用户 ID
+   * @param {string} sessionKey 小程序 session key
+   * @param {number} type 类型
+   */
+  async getSubCorpMiniProgramSession(userId, sessionKey, type = 1) {
+    return this.post('/thirdparty/get_sub_corp_mini_program_session', {
+      userid: userId,
+      session_key: sessionKey,
+      type
+    });
+  }
+
+  /**
+   * 获取应用共享信息
+   * @param {string} agentId 应用 ID
+   */
+  async getCorpSharedInfo(agentId) {
+    return this.post('/thirdparty/get_corp_shared_info', { agentid: agentId });
+  }
+
+  // ========== 通讯录同步 ==========
+
+  /**
+   * 激活下级企业
+   * @param {string} corpId 下级企业 ID
+   * @param {number} activateState 激活状态
+   */
+  async activateCorp(corpId, activateState = 1) {
+    return this.post('/thirdparty/activate_corp', {
+      corpid: corpId,
+      activate_state: activateState
+    });
+  }
+
+  /**
+   * 设置下级企业同步范围
+   * @param {string} corpId 下级企业 ID
+   * @param {number[]} departmentIds 部门 ID 列表
+   */
+  async setSyncScope(corpId, departmentIds) {
+    return this.post('/thirdparty/set_sync_scope', {
+      corpid: corpId,
+      department_ids: departmentIds
+    });
+  }
+
+  // ========== 应用管理 ==========
+
+  /**
+   * 获取下级企业应用列表
+   * @param {string} corpId 下级企业 ID
+   */
+  async getSubCorpAgentList(corpId) {
+    return this.post('/thirdparty/agent/list', { corpid: corpId });
+  }
+
+  /**
+   * 设置下级企业应用
+   * @param {string} corpId 下级企业 ID
+   * @param {number} agentId 应用 ID
+   * @param {object} params 应用参数
+   */
+  async setSubCorpAgent(corpId, agentId, params) {
+    return this.post('/thirdparty/agent/set', {
+      corpid: corpId,
+      agentid: agentId,
+      ...params
+    });
+  }
+
+  // ========== 消息推送 ==========
+
+  /**
+   * 给下级企业发送消息
+   * @param {string} corpId 下级企业 ID
+   * @param {string} toUser 接收成员
+   * @param {object} content 消息内容
+   * @param {string} msgType 消息类型
+   */
+  async sendToSubCorp(corpId, toUser, content, msgType = 'text') {
+    return this.post('/thirdparty/message/send', {
+      corpid: corpId,
+      touser: toUser,
+      msgtype: msgType,
+      [msgType]: content
+    });
+  }
+}
+
+module.exports = ThirdParty;