API文档

智能体对接企业微信接口文档

一、接口概述

接口名称：企业微信员工数据接口

接口描述：用于获取和处理企业微信员工数据

接口版本：1.0

接口作者/维护者：霍巴科技团队

创建日期：2025-04-10

二、接口请求信息

接口1：获取全部员工userid数据

GET https://qywchat.api.aigcstudio51.com/api/member-departments 测试接口
获取企业微信中所有员工的userid和部门信息

请求参数

无额外请求参数

响应示例

[
    {"userid":"SongYiLing","department":[1]},
    {"userid":"GuoJian","department":[1]},
    {"userid":"NingLi","department":[1]},
    {"userid":"donDanDan","department":[1]},
    {"userid":"GuoYuLong","department":[1]},
    {"userid":"LiuHaiYan","department":[2]}
]
上传Excel文件接口，用于上传智能体与企业微信协作数据。

接口2：获取员工详细数据

GET https://qywchat.api.aigcstudio51.com/api/member-detail 测试接口
获取指定员工的详细信息

请求参数

参数名 必选 类型 描述 示例值
userId 是 string 员工的userid，用于指定获取哪位员工的详细数据 GuoYuLong

响应示例

{
    "status": "success",
    "data": {
        "姓名": "郭雨龙",
        "账号": "GuoYuLong",
        "部门": "元生视界AI/其他（待设置部门）",
        "性别": "男",
        "手机": "18601388064",
        "邮箱": "",
        "激活状态": "已激活"
    }
}

接口3：获取指定员工一定时间的打卡数据

GET https://qywchat.api.aigcstudio51.com/api/check-in-data 测试接口
获取指定员工的打卡记录

请求参数

参数名 必选 类型 描述 示例值
userId 是 string 员工的userid，用于指定获取哪位员工的打卡数据 GuoYuLong

响应示例

{
    "status": "success",
    "data": [
        {
            "userid": "GuoYuLong",
            "groupname": "试运行",
            "checkin_type": "上班打卡",
            "exception_type": "",
            "checkin_time": 1744023592,
            "location_title": "南京霍巴",
            "location_detail": "江苏省南京市浦口区新浦路新城总部大厦",
            "wifiname": "hoba2021_5G",
            "notes": "",
            "wifimac": "62:db:15:79:a1:f4",
            "mediaids": [],
            "lat": 32065890,
            "lng": 118647540,
            "deviceid": "74576ae2e390d606",
            "groupid": 1
        },
        {
            "userid": "GuoYuLong",
            "groupname": "试运行",
            "checkin_type": "下班打卡",
            "exception_type": "未打卡",
            "checkin_time": 1744041599,
            "location_title": "",
            "location_detail": "",
            "wifiname": "",
            "notes": "",
            "wifimac": "",
            "mediaids": [],
            "lat": 0,
            "lng": 0,
            "deviceid": "",
            "sch_checkin_time": 1744041599,
            "groupid": 1
        }
    ]
}

接口4：为员工打卡

GET https://qywchat.api.aigcstudio51.com/api/add-checkin 测试接口
为企业微信员工提交打卡记录

请求参数

参数名 必选 类型 描述 示例值
userId 是 string 员工的userid，用于指定为哪位员工打卡 GuoYuLong
location 是 object 打卡位置信息 {"title":"办公室","detail":"3楼会议室","lat":39.9042,"lng":116.4074}

响应示例

{
    "status": "success",
    "message": "打卡记录已成功提交到企业微信",
    "data": {
        "errcode": 0,
        "errmsg": "ok"
    }
}

三、注意事项

  • 调用接口时，请确保网络稳定，避免因网络波动导致请求失败。
  • 接口1返回的员工userid数据顺序可能不固定，使用时请根据实际业务需求处理。
  • 调用接口2、接口3和接口4时，请确保传入的userId参数准确无误，否则可能获取不到正确数据或返回错误信息。
  • 调用接口4时，注意location参数的格式需严格按照示例，包含title、detail、lat、lng四个字段，否则可能导致打卡失败。
  • 企业微信管理员可通过https://qywchat.api.aigcstudio51.com/upload.html网页，上传企业员工Excel表格数据。

请求参数

参数名 类型 必填 描述
excelFile File 是 上传的Excel文件，支持.xlsx和.xls格式

响应示例

{
    "success": true,
    "message": "文件上传成功",
    "data": {
        "filename": "example.xlsx",
        "size": 1024
    }
}