飞书平台连接器获取及设置指南

获取连接器

应用连接器获取步骤

• 文档地址：飞书API列表

创建应用

• 链接地址：创建应用

应用授权

根据调用接口获取相应权限信息，支持批量获取。

应用发版

完成授权后，选择应用并进行版本发布，还需通过审核。 参数说明：

• host：飞书API接口地址，如 https://open.feishu.cn
• app_id：飞书应用的app_id
• app_secret：飞书应用的secret

方案配置指南

适配器介绍

• FSExecuteAdapter：写入适配器
• FSQueryAdapter：查询适配器
• FSApprovalExecuteAdapter：审批写入适配器
• FSApprovalQueryAdapter：审批查询适配器
• GetUserAdapter：通过部门查询用户信息

查询方案配置示例

示例方案：

• 查询部门：链接
• 用户查询：链接
• 审批示例：链接

请求参数说明

path参数说明

在飞书API中，有些参数需要放到请求地址path中。例如，查询部门列表时，链接 中的 department_id 需要替换路径中的 /open-apis/contact/v3/departments/:department_id/children。

query参数说明

放到请求地址的query里面，例如用户查询：链接。其中 department_id, page_size, page_token 等参数需要通过 ? 带上 query 参数。

body参数说明

POST请求的大部分body是放在请求参数request里面。

方案配置说明

参数配置指南

1. query 参数，放在请求参数request中。其他请求参数放在otherRequest中，在生成队列时，会自动带上query关键字。
2. path 参数，放在 otherRequest 中，并且需要配置 path 关键字。
3. body 参数，放在 request 中，一般用于 POST、DELETE 等方法。如果同时有 query 参数，需要配置到 otherRequest 中。

{
    "query": {
        "page_size": "20",
        "page_token": ""
    },
    "path": {
        "department_id": "od-dfddfe844c6c51e8bc069815eaf72236f"
    }
}

4. 如果是通过部门查询客户列表，请配置 dep_strategy 参数，即部门方案ID。
5. 部门审批，请参考这个链接。