飞书推送工具
要获取飞书开发所需的 APP_ID、APP_SECRET 以及用户的 USER_ID,需通过飞书开放平台和飞书客户端的相关设置操作。以下是详细步骤:
一、获取 APP_ID 和 APP_SECRET(飞书应用凭证)
APP_ID 和 APP_SECRET 是飞书开放平台为应用分配的唯一凭证,用于接口调用的身份验证。需先创建一个飞书应用(企业自建应用):
1. 登录飞书开放平台
- 访问飞书开放平台官网:飞书开放平台
- 使用企业管理员账号登录(个人账号可能无权限创建企业应用)。
2. 创建企业自建应用
- 登录后,进入「开发者后台」→ 「应用列表」→ 点击「创建应用」。
- 选择「企业自建应用」(适用于企业内部使用的应用),填写应用名称(如 “测试报告推送工具”),选择应用图标,点击「确定」。
3. 获取 APP_ID 和 APP_SECRET
- 应用创建后,进入应用详情页,在左侧导航栏选择「凭证与基础信息」。
- 在「应用凭证」栏目中,即可看到 APP_ID(应用 ID)和 APP_SECRET(应用密钥)。
- 注意:APP_SECRET 为敏感信息,需妥善保管,不要泄露给无关人员。
二、获取 USER_ID(飞书用户 ID)
USER_ID 是飞书用户的唯一标识(通常为一串字符串,如 ou_xxxxxx),用于指定消息的接收者。获取方式有两种:
方法 1:通过飞书客户端查询
- 打开飞书客户端,进入目标用户的聊天窗口。
- 点击用户头像,进入用户资料页。
- 点击资料页右上角的「...」→「更多信息」,在「用户 ID」栏目中即可看到 USER_ID(格式通常为 ou_ 开头)。
方法 2:通过飞书开放平台接口查询
如果需要批量获取用户 ID,可调用飞书开放平台的「获取用户信息」接口(需先为应用添加「通讯录」权限):
- 在应用详情页的「权限管理」中,申请「获取用户基本信息」「获取部门用户列表」等权限,并等待企业管理员审批。
- 调用接口 GET /contact/v3/users,传入用户手机号或邮箱,即可返回对应的 USER_ID。
- 接口文档参考:飞书开放平台 - 获取用户信息
三、补充说明
- REPORT_PATH:这是本地测试报告的路径(如 ./test_report.html),无需从飞书获取,只需确保该路径在打包后的 EXE 文件运行环境中存在且正确即可。
- 权限配置:如果应用需要向用户推送消息,需在「权限管理」中申请「消息推送」相关权限(如「发送单聊消息」),否则接口调用会失败。
- 调试建议:在开发阶段,可先通过飞书开放平台的「API 调试工具」测试接口调用是否成功,确认 APP_ID、APP_SECRET 和 USER_ID 无误后,再集成到代码中。
通过以上步骤,即可获取代码中所需的 APP_ID、APP_SECRET 和 USER_ID,进而实现通过飞书推送消息的功能。