考勤机接口文档：员工与考勤操作详解

本文档详细介绍了公司中控考勤机接口的相关功能和操作方法，主要涉及三个核心接口：新增员工接口、人员信息查询接口以及人员考勤查询接口。 1. **新增员工接口** - **接口描述**：此接口用于向考勤机数据库中插入员工的基本信息，包含部门编号（如C004测试部、C011产品部）和员工姓名。使用POST方法通过HTTPS访问`http://yourwebsite:8080`，请求体需携带必要的参数。 - **参数说明**： - `method`: 固定值，表示调用方法名，即`employee_service` - `unixtime`: 当前时间戳，以东八区为准 - `sign`: 使用MD5加密算法生成的认证签名，包含签名字符串、时间戳和方法名 - `param`: 必须的JSON格式参数，包括`DeptID`（部门编号）和`EName`（员工姓名） 2. **人员信息查询接口** - **接口功能**：根据人员编号查询员工的详细信息。同样使用POST请求，但参数不同。 - **参数说明**： - `method`：固定值，用于标识调用方法 - `unixtime`：时间戳 - `sign`：加密后的认证签名 - `param`：JSON格式参数，包含`DeptID`（可选）和`EName`（可选），用于指定查询条件 3. **人员考勤查询接口** - **功能概述**：允许根据人员编号、打卡开始时间和打卡结束时间查询考勤记录。POST请求，携带详细参数。 - **参数说明**： - `method`：调用方法名 - `unixtime`：时间戳 - `sign`：加密签名 - `param`：JSON格式参数，包括`DeptID`、`EName`、打卡时间范围等，用于检索特定时间段内的考勤数据 所有接口均返回JSON格式的结果，包括`success`状态标志（true表示成功，false表示失败）和相应的`msg`信息，用于提供调用结果的反馈。对于每个接口，文档还给出了调用成功的示例返回和失败的示例返回，帮助开发者理解和使用这些接口。 总体来说，这份接口文档为IT工作人员提供了清晰的指导，让他们能够在开发与考勤机系统交互的应用程序时，了解如何正确地发送请求、处理数据并解读返回结果，确保了系统的稳定集成和高效运行。