@jiexiaoyin/wecom-api 0.0.2

package/src/modules/room/index.js

@@ -0,0 +1,178 @@
+/**
+ * 会议室模块
+ * API 章节：二十五 - 会议室
+ * 包含：会议室管理、会议室预定管理
+ * 注意：与会议模块(meeting)的Rooms不同，这里是独立的会议室系统
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Room extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 会议室管理 ==========
+
+  /**
+   * 获取会议室列表
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getMeetingRoomList(offset = 0, size = 100) {
+    return this.post('/meetingroom/list', { offset, limit: size });
+  }
+
+  /**
+   * 获取会议室详情
+   * @param {string} meetingRoomId 会议室 ID
+   */
+  async getMeetingRoomDetail(meetingRoomId) {
+    return this.post('/meetingroom/get', { meetingroom_id: meetingRoomId });
+  }
+
+  /**
+   * 添加会议室
+   * @param {object} room 会议室信息
+   */
+  async addMeetingRoom(room) {
+    return this.post('/meetingroom/add', room);
+  }
+
+  /**
+   * 修改会议室
+   * @param {string} meetingRoomId 会议室 ID
+   * @param {object} room 会议室信息
+   */
+  async updateMeetingRoom(meetingRoomId, room) {
+    return this.post('/meetingroom/edit', {
+      meetingroom_id: meetingRoomId,
+      ...room
+    });
+  }
+
+  /**
+   * 删除会议室
+   * @param {string} meetingRoomId 会议室 ID
+   */
+  async deleteMeetingRoom(meetingRoomId) {
+    return this.post('/meetingroom/del', { meetingroom_id: meetingRoomId });
+  }
+
+  // ========== 会议室预定管理 ==========
+
+  /**
+   * 预定会议室
+   * @param {string} meetingRoomId 会议室 ID
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} userId 预定人 ID
+   * @param {string} subject 会议主题
+   */
+  async bookMeetingRoom(meetingRoomId, startTime, endTime, userId, subject = '') {
+    return this.post('/meetingroom/book', {
+      meetingroom_id: meetingRoomId,
+      start_time: startTime,
+      end_time: endTime,
+      userid: userId,
+      subject
+    });
+  }
+
+  /**
+   * 取消预定会议室
+   * @param {string} meetingRoomId 会议室 ID
+   * @param {string} bookingId 预定记录 ID
+   */
+  async cancelMeetingRoomBooking(meetingRoomId, bookingId) {
+    return this.post('/meetingroom/cancel_book', {
+      meetingroom_id: meetingRoomId,
+      booking_id: bookingId
+    });
+  }
+
+  /**
+   * 获取会议室预定情况
+   * @param {string} meetingRoomId 会议室 ID
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   */
+  async getMeetingRoomBookings(meetingRoomId, startTime, endTime) {
+    return this.post('/meetingroom/get_booking_info', {
+      meetingroom_id: meetingRoomId,
+      start_time: startTime,
+      end_time: endTime
+    });
+  }
+
+  /**
+   * 获取用户预定列表
+   * @param {string} userId 用户 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getUserBookings(userId, offset = 0, size = 100) {
+    return this.post('/meetingroom/user_booking_list', {
+      userid: userId,
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取会议室可用时间
+   * @param {string} meetingRoomId 会议室 ID
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   */
+  async getMeetingRoomAvailableTime(meetingRoomId, startTime, endTime) {
+    return this.post('/meetingroom/get_available_time', {
+      meetingroom_id: meetingRoomId,
+      start_time: startTime,
+      end_time: endTime
+    });
+  }
+
+  /**
+   * 设置会议室管理员
+   * @param {string} meetingRoomId 会议室 ID
+   * @param {string[]} userIds 管理员 userid 列表
+   */
+  async setMeetingRoomAdmins(meetingRoomId, userIds) {
+    return this.post('/meetingroom/set_admins', {
+      meetingroom_id: meetingRoomId,
+      userids: userIds
+    });
+  }
+
+  // ========== 会议室分组管理 ==========
+
+  /**
+   * 获取会议室分组列表
+   */
+  async getMeetingRoomGroupList() {
+    return this.post('/meetingroom/group_list', {});
+  }
+
+  /**
+   * 创建会议室分组
+   * @param {string} groupName 分组名称
+   * @param {string[]} roomIds 会议室 ID 列表
+   */
+  async createMeetingRoomGroup(groupName, roomIds) {
+    return this.post('/meetingroom/group_add', {
+      group_name: groupName,
+      meetingroom_ids: roomIds
+    });
+  }
+
+  /**
+   * 删除会议室分组
+   * @param {string} groupId 分组 ID
+   */
+  async deleteMeetingRoomGroup(groupId) {
+    return this.post('/meetingroom/group_del', { group_id: groupId });
+  }
+}
+
+module.exports = Room;

package/src/modules/schedule/index.js

@@ -0,0 +1,246 @@
+/**
+ * 日程管理模块
+ * API 章节：十六 - 日程
+ * 包含：管理日历、管理日程
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Schedule extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 管理日历 ==========
+
+  /**
+   * 创建日历
+   * @param {object} params 日历参数
+   */
+  async createCalendar(params) {
+    const { title, color, description, shares, calendarIds } = params;
+    return this.post('/oa/calendar/add', {
+      calendar: {
+        title,
+        color,
+        description,
+        shares,
+        calendar_ids: calendarIds
+      }
+    });
+  }
+
+  /**
+   * 更新日历
+   * @param {string} calendarId 日历 id
+   * @param {object} params 更新参数
+   */
+  async updateCalendar(calendarId, { title, color, description, shares }) {
+    return this.post('/oa/calendar/update', {
+      calendar: {
+        calendar_id: calendarId,
+        title,
+        color,
+        description,
+        shares
+      }
+    });
+  }
+
+  /**
+   * 获取日历详情
+   * @param {string} calendarId 日历 id
+   */
+  async getCalendar(calendarId) {
+    return this.post('/oa/calendar/get', { calendar_id: calendarId });
+  }
+
+  /**
+   * 删除日历
+   * @param {string} calendarId 日历 id
+   */
+  async deleteCalendar(calendarId) {
+    return this.post('/oa/calendar/del', { calendar_id: calendarId });
+  }
+
+  // ========== 管理日程 ==========
+
+  /**
+   * 创建日程
+   * @param {object} params 日程参数
+   */
+  async createEvent(params) {
+    const {
+      organizer, title, startTime, endTime, attendees,
+      description, location, reminders, meetingId, roomId
+    } = params;
+
+    const event = {
+      organizer,
+      title,
+      start: {
+        timestamp: Math.floor(new Date(startTime).getTime() / 1000),
+        timezone: 'Asia/Shanghai'
+      },
+      end: {
+        timestamp: Math.floor(new Date(endTime).getTime() / 1000),
+        timezone: 'Asia/Shanghai'
+      }
+    };
+
+    if (attendees) event.attendees = attendees;
+    if (description) event.description = description;
+    if (location) event.location = { name: location };
+    if (reminders) event.reminders = reminders;
+    if (meetingId) event.meeting_id = meetingId;
+    if (roomId) event.room_id = roomId;
+
+    return this.post('/oa/schedule/add', { schedule: event });
+  }
+
+  /**
+   * 更新日程
+   * @param {string} scheduleId 日程 id
+   * @param {object} params 更新参数
+   */
+  async updateEvent(scheduleId, params) {
+    const { title, startTime, endTime, attendees, description, location, reminders } = params;
+
+    const event = {
+      schedule_id: scheduleId
+    };
+
+    if (title) event.title = title;
+    if (startTime) {
+      event.start = {
+        timestamp: Math.floor(new Date(startTime).getTime() / 1000),
+        timezone: 'Asia/Shanghai'
+      };
+    }
+    if (endTime) {
+      event.end = {
+        timestamp: Math.floor(new Date(endTime).getTime() / 1000),
+        timezone: 'Asia/Shanghai'
+      };
+    }
+    if (attendees) event.attendees = attendees;
+    if (description) event.description = description;
+    if (location) event.location = { name: location };
+    if (reminders) event.reminders = reminders;
+
+    return this.post('/oa/schedule/update', { schedule: event });
+  }
+
+  /**
+   * 更新重复日程
+   * @param {string} scheduleId 日程 id
+   * @param {string} seriesId 重复系列 id
+   * @param {object} params 更新参数
+   */
+  async updateRecurringEvent(scheduleId, seriesId, params) {
+    const { title, startTime, endTime, attendees, description, location, reminders } = params;
+
+    const event = {
+      schedule_id: scheduleId,
+      series_id: seriesId
+    };
+
+    if (title) event.title = title;
+    if (startTime) {
+      event.start = {
+        timestamp: Math.floor(new Date(startTime).getTime() / 1000),
+        timezone: 'Asia/Shanghai'
+      };
+    }
+    if (endTime) {
+      event.end = {
+        timestamp: Math.floor(new Date(endTime).getTime() / 1000),
+        timezone: 'Asia/Shanghai'
+      };
+    }
+    if (attendees) event.attendees = attendees;
+    if (description) event.description = description;
+    if (location) event.location = { name: location };
+    if (reminders) event.reminders = reminders;
+
+    return this.post('/oa/schedule/update', { schedule: event });
+  }
+
+  /**
+   * 删除日程
+   * @param {string} scheduleId 日程 id
+   */
+  async deleteEvent(scheduleId) {
+    return this.post('/oa/schedule/del', { schedule_id: scheduleId });
+  }
+
+  /**
+   * 删除重复日程
+   * @param {string} scheduleId 日程 id
+   * @param {string} seriesId 重复系列 id
+   * @param {number} type 删除类型: 1-单日 2-后续 3-全部
+   */
+  async deleteRecurringEvent(scheduleId, seriesId, type = 1) {
+    return this.post('/oa/schedule/del', {
+      schedule_id: scheduleId,
+      series_id: seriesId,
+      type
+    });
+  }
+
+  /**
+   * 新增日程参与者
+   * @param {string} scheduleId 日程 id
+   * @param {string[]} attendees 参与者 userid 列表
+   */
+  async addEventAttendees(scheduleId, attendees) {
+    return this.post('/oa/schedule/addattendees', {
+      schedule_id: scheduleId,
+      attendees
+    });
+  }
+
+  /**
+   * 删除日程参与者
+   * @param {string} scheduleId 日程 id
+   * @param {string[]} attendees 参与者 userid 列表
+   */
+  async removeEventAttendees(scheduleId, attendees) {
+    return this.post('/oa/schedule/delattendees', {
+      schedule_id: scheduleId,
+      attendees
+    });
+  }
+
+  /**
+   * 获取日历下的日程列表
+   * @param {string} calendarId 日历 id
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   */
+  async getCalendarEvents(calendarId, startTime, endTime) {
+    return this.post('/oa/schedule/list', {
+      calendar_id: calendarId,
+      start_time: startTime,
+      end_time: endTime
+    });
+  }
+
+  /**
+   * 获取日程详情
+   * @param {string} scheduleId 日程 id
+   */
+  async getEventDetail(scheduleId) {
+    return this.post('/oa/schedule/get', { schedule_id: scheduleId });
+  }
+
+  /**
+   * 取消日程
+   * @param {string} scheduleId 日程 id
+   */
+  async cancelEvent(scheduleId) {
+    return this.deleteEvent(scheduleId);
+  }
+}
+
+module.exports = Schedule;

package/src/modules/school/index.js

@@ -0,0 +1,199 @@
+/**
+ * 家校消息模块
+ * API 章节：八 - 家校消息
+ * 包含：学校通知
+ */
+
+const WeComSDK = require('../../sdk');
+
+class School extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 学校通知 ==========
+
+  /**
+   * 发送学校通知
+   * @param {string} userId 老师 ID
+   * @param {string} studentUserId 学生 userid（家校通知时必填）
+   * @param {object} content 通知内容
+   */
+  async sendSchoolNotice(userId, studentUserId, content) {
+    const { title, content: text, mediaId, msgType = 'text' } = content;
+    
+    const params = {
+      userid: userId,
+      msgtype: msgType
+    };
+
+    // 如果是家校通知，需要传入学生信息
+    if (studentUserId) {
+      params.student_userid = studentUserId;
+    }
+
+    switch (msgType) {
+      case 'text':
+        params.text = { content: text };
+        break;
+      case 'image':
+        params.image = { media_id: mediaId };
+        break;
+      case 'voice':
+        params.voice = { media_id: mediaId };
+        break;
+      case 'video':
+        params.video = { media_id: mediaId };
+        break;
+      case 'file':
+        params.file = { media_id: mediaId };
+        break;
+      case 'news':
+        params.news = { articles: content.articles };
+        break;
+      case 'mpnews':
+        params.mpnews = { articles: content.articles };
+        break;
+    }
+
+    return this.post('/school/send_notice', params);
+  }
+
+  /**
+   * 获取学校通知发送结果
+   * @param {string} msgId 消息 ID
+   */
+  async getSchoolNoticeResult(msgId) {
+    return this.post('/school/get_notice_result', { msg_id: msgId });
+  }
+
+  /**
+   * 撤回学校通知
+   * @param {string} msgId 消息 ID
+   */
+  async recallSchoolNotice(msgId) {
+    return this.post('/school/recall_notice', { msg_id: msgId });
+  }
+
+  // ========== 家校通讯录 ==========
+
+  /**
+   * 获取班级列表
+   * @param {string} schoolId 学校 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getClassList(schoolId, offset = 0, size = 100) {
+    return this.post('/school/get_class_list', {
+      schoolid: schoolId,
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取学生列表
+   * @param {string} classId 班级 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getStudentList(classId, offset = 0, size = 100) {
+    return this.post('/school/get_student_list', {
+      classid: classId,
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取家长列表
+   * @param {string} studentUserId 学生 userid
+   */
+  async getParentList(studentUserId) {
+    return this.post('/school/get_parent_list', { student_userid: studentUserId });
+  }
+
+  /**
+   * 获取老师列表
+   * @param {string} schoolId 学校 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getTeacherList(schoolId, offset = 0, size = 100) {
+    return this.post('/school/get_teacher_list', {
+      schoolid: schoolId,
+      offset,
+      limit: size
+    });
+  }
+
+  // ========== 健康上报 ==========
+
+  /**
+   * 创建健康上报任务
+   * @param {string} schoolId 学校 ID
+   * @param {string} classId 班级 ID
+   * @param {object} task 上报任务配置
+   */
+  async createHealthReportTask(schoolId, classId, task) {
+    return this.post('/school/add_health_report_task', {
+      schoolid: schoolId,
+      classid: classId,
+      ...task
+    });
+  }
+
+  /**
+   * 获取健康上报统计
+   * @param {string} taskId 任务 ID
+   */
+  async getHealthReportStat(taskId) {
+    return this.post('/school/get_health_report_stat', { task_id: taskId });
+  }
+
+  /**
+   * 获取健康上报详情
+   * @param {string} taskId 任务 ID
+   * @param {string} studentUserId 学生 userid
+   */
+  async getHealthReportDetail(taskId, studentUserId) {
+    return this.post('/school/get_health_report_detail', {
+      task_id: taskId,
+      student_userid: studentUserId
+    });
+  }
+
+  // ========== 成绩管理 ==========
+
+  /**
+   * 发布成绩
+   * @param {string} schoolId 学校 ID
+   * @param {string} studentUserId 学生 userid
+   * @param {object} score 成绩信息
+   */
+  async publishScore(schoolId, studentUserId, score) {
+    return this.post('/school/publish_score', {
+      schoolid: schoolId,
+      student_userid: studentUserId,
+      ...score
+    });
+  }
+
+  /**
+   * 获取成绩列表
+   * @param {string} schoolId 学校 ID
+   * @param {string} studentUserId 学生 userid
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getScoreList(schoolId, studentUserId, offset = 0, size = 100) {
+    return this.post('/school/get_score_list', {
+      schoolid: schoolId,
+      student_userid: studentUserId,
+      offset,
+      limit: size
+    });
+  }
+}
+
+module.exports = School;