SuperAPI AI 工具集

lark

编程与开发

查看项目

更新于 10-16 02:36

技能介绍

用途:该技能面向 Lark(飞书)开放平台 API,帮助在命令行环境中完成协作类操作,包括消息发送、群聊管理、通讯录查询、日历日程管理和机器人信息获取。

主要能力:

  1. 消息:向用户或群聊发送文本、富文本(post)、图片和交互式卡片消息,支持回复消息与获取会话历史。
  2. 群组:创建群聊、列出全部群聊、获取群信息、添加或移除成员。
  3. 通讯录:获取用户信息、通过邮箱或手机号批量查询用户 ID、列出部门、获取部门成员。
  4. 日历:列出日历、创建日历、创建日程事件、列出日历事件。
  5. 机器人:获取机器人信息。

使用方式:所有请求通过 curl 调用 https://open.larksuite.com/open-apis/ 下的接口,并在请求头携带 Authorization: Bearer ${TOKEN}。令牌来自运行时环境变量 LARK_TOKEN,需先连接 Lark 连接器。示例中使用 get_lark_token 辅助函数读取令牌,缺失时明确报错。请求体通常写入 /tmp/lark_request.json 后以 -d @ 方式提交。

排障:若连接器已连接但请求失败,可运行 zero doctor check-connector --env-name LARK_TOKEN 与 zero doctor check-connector --url https://open.larksuite.com/open-apis/bot/v3/info --method GET 检查令牌与 API 访问。LARK_TOKEN 是 bearer token,不可当作 app secret 使用。

限制与注意:Lark 对每个应用有速率限制,批量操作需加延迟;消息 content 需做 JSON 转义,可用 jq 构建复杂载荷;日历事件需 Unix 时间戳,Linux 与 macOS 的 date 命令参数不同;响应中 code 为 0 表示成功,非 0 表示错误。ID 类型方面,用户操作多用 open_id,群聊使用 chat_id。复杂交互卡片可借助 Lark Card Builder 设计。

适用场景:需要以脚本或自动化方式在 Lark 中发消息、建群、查组织架构或安排会议时使用。

暂未提供:具体收费、价格、平台支持范围及效果数据未在资料中说明。