UNPKG

@larksuiteoapi/lark-mcp

Version:

Feishu/Lark OpenAPI MCP

github.com/larksuite/lark-openapi-mcp

898 lines • 111 kB

JavaScript

"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.approvalV4Tools = exports.approvalV4TaskTransfer = exports.approvalV4TaskSearch = exports.approvalV4TaskResubmit = exports.approvalV4TaskReject = exports.approvalV4TaskQuery = exports.approvalV4TaskApprove = exports.approvalV4InstanceSpecifiedRollback = exports.approvalV4InstanceSearchCc = exports.approvalV4InstanceQuery = exports.approvalV4InstancePreview = exports.approvalV4InstanceList = exports.approvalV4InstanceGet = exports.approvalV4InstanceCreate = exports.approvalV4InstanceCommentRemove = exports.approvalV4InstanceCommentList = exports.approvalV4InstanceCommentDelete = exports.approvalV4InstanceCommentCreate = exports.approvalV4InstanceCc = exports.approvalV4InstanceCancel = exports.approvalV4InstanceAddSign = exports.approvalV4ExternalTaskList = exports.approvalV4ExternalInstanceCreate = exports.approvalV4ExternalInstanceCheck = exports.approvalV4ExternalApprovalGet = exports.approvalV4ExternalApprovalCreate = exports.approvalV4ApprovalUnsubscribe = exports.approvalV4ApprovalSubscribe = exports.approvalV4ApprovalGet = exports.approvalV4ApprovalCreate = void 0; const zod_1 = require("zod"); exports.approvalV4ApprovalCreate = { project: 'approval', name: 'approval.v4.approval.create', sdkName: 'approval.v4.approval.create', path: '/open-apis/approval/v4/approvals', httpMethod: 'POST', description: '[Feishu/Lark]-审批-原生审批定义-创建审批定义-该接口用于创建审批定义，可以灵活指定审批定义的基础信息、表单和流程等', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ approval_name: zod_1.z.string().describe('审批名称的国际化文案 Key，以 `@i18n@` 开头，长度不得少于 9 个字符'), approval_code: zod_1.z .string() .describe('审批定义 Code。使用说明：- 该参数不传值时，表示新建审批定义，最终响应结果会返回由系统自动生成的审批定义 Code。- 该参数传入指定审批定义 Code 时，表示调用该接口更新该审批定义内容，更新方式为覆盖原定义内容的全量更新。审批定义 Code。获取方式：- 调用接口后，从响应参数 approval_code 获取。- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见') .optional(), description: zod_1.z.string().describe('审批描述的国际化文案 Key，以 `@i18n@` 开头，长度不得少于 9 个字符').optional(), viewers: zod_1.z .array(zod_1.z.object({ viewer_type: zod_1.z .enum(['TENANT', 'DEPARTMENT', 'USER', 'NONE']) .describe('审批定义的可见范围 Options:TENANT(当前企业内可见),DEPARTMENT(指定部门可见),USER(指定用户可见),NONE(任何人都不可见)') .optional(), viewer_user_id: zod_1.z .string() .describe('当 viewer_type 是 USER 时，需要通过该参数传入用户 ID，ID 类型与查询参数 user_id_type 取值一致') .optional(), viewer_department_id: zod_1.z .string() .describe('当 viewer_type 为DEPARTMENT，需要通过该参数传入部门 ID，ID 类型与查询参数 department_id_type 取值一致') .optional(), })) .describe('viewers 字段指定了哪些人能从审批应用的前台发起该审批。使用说明： - 当 viewer_type 为 USER，需要填写 viewer_user_id - 当 viewer_type 为 DEPARTMENT，需要填写 viewer_department_id - 当 viewer_type 为 TENANT 或 NONE 时，无需填写 viewer_user_id 和 viewer_department_id**注意**：列表最大长度为 200'), form: zod_1.z .object({ form_content: zod_1.z .string() .describe('审批定义表单。表单格式为 JSON 数组，实际传值时需要将 JSON 压缩转义为 String 类型。表单内各个控件的 JSON 字段说明参见。**注意**：以下示例值未转义，你可以参考下文**请求示例**章节的示例代码'), }) .describe('审批定义表单'), node_list: zod_1.z .array(zod_1.z.object({ id: zod_1.z .string() .describe('节点 ID。- 开始节点的 ID 为 START- 结束节点的 ID 为 END开始和结束节点不需要指定 name、node_type 以及 approver'), name: zod_1.z.string().describe('节点名称的国际化文案 Key，以 `@i18n@` 开头，长度不得少于 9 个字符').optional(), node_type: zod_1.z .enum(['AND', 'OR', 'SEQUENTIAL']) .describe('当前节点的审批方式。**注意**：当该参数取值为依次审批（SEQUENTIAL）时，审批人类型（approver.type）必须为发起人自选（Free）。 Options:AND(会签，需要所有审批人同意才会通过审批),OR(或签，一名审批人同意即可通过审批),SEQUENTIAL(Sequental 依次审批，按照审批人顺序依次进行审批)') .optional(), approver: zod_1.z .array(zod_1.z.object({ type: zod_1.z .enum([ 'Supervisor', 'SupervisorTopDown', 'DepartmentManager', 'DepartmentManagerTopDown', 'Personal', 'Free', ]) .describe('审批人类型。使用说明：- 该参数取值为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 参数中填写对应的级数。例如：由下往上三级主管审批，该参数取值 Supervisor 、level 参数取值 3。 - 该参数取值为 Personal 时，需要填写对应的 user_id ，用于指定用户。 - 该参数取值为 Free 时，无需指定 user_id 和 level。 Options:Supervisor(主管审批（由下往上）),SupervisorTopDown(主管审批（从上往下）),DepartmentManager(部门负责人审批（由下往上）),DepartmentManagerTopDown(部门负责人审批（从上往下）),Personal(指定成员),Free(发起人自选)'), user_id: zod_1.z .string() .describe('用户 ID。- type 取值 Personal 时需要通过该参数设置指定的用户。- ID 类型与查询参数 user_id_type 取值一致') .optional(), level: zod_1.z .string() .describe('审批级数。当 type 取值为 Supervisor、SupervisorTopDown、DepartmentManager、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数。例如：由下往上三级主管审批，level 取值 3') .optional(), })) .describe('审批人列表') .optional(), ccer: zod_1.z .array(zod_1.z.object({ type: zod_1.z .enum([ 'Supervisor', 'SupervisorTopDown', 'DepartmentManager', 'DepartmentManagerTopDown', 'Personal', 'Free', ]) .describe('抄送人类型。使用说明：- 该参数取值为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 参数中填写对应的级数。例如：抄送由下往上三级主管，该参数取值 Supervisor 、level 参数取值 3。 - 该参数取值为 Personal 时，需要填写对应的 user_id ，用于指定用户。 - 该参数取值为 Free 时，无需指定 user_id 和 level。- 抄送人类型不支持设置为发起人自选（Free）。 Options:Supervisor(主管审批（由下往上）),SupervisorTopDown(主管审批（从上往下）),DepartmentManager(部门负责人审批（由下往上）),DepartmentManagerTopDown(部门负责人审批（从上往下）),Personal(指定成员),Free(发起人自选（抄送人类型不支持该选项）)'), user_id: zod_1.z .string() .describe('用户 ID。- type 取值 Personal 时需要通过该参数设置指定的用户。- ID 类型与查询参数 user_id_type 取值一致') .optional(), level: zod_1.z .string() .describe('审批级数。当 type 取值为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数。例如：抄送由下往上三级主管，level 取值 3') .optional(), })) .describe('抄送人列表') .optional(), privilege_field: zod_1.z .object({ writable: zod_1.z .array(zod_1.z.string()) .describe('可写权限的表单控件项的 ID 列表，ID 需要与表单参数（form）内传入的控件 ID 值保持一致'), readable: zod_1.z .array(zod_1.z.string()) .describe('可读权限的表单控件项的 ID 列表，ID 需要与表单参数（form）内传入的控件 ID 值保持一致'), }) .describe('表单内的控件权限') .optional(), approver_chosen_multi: zod_1.z .boolean() .describe('发起人自选审批人时，是否允许多选。- true：允许- false：不允许') .optional(), approver_chosen_range: zod_1.z .array(zod_1.z.object({ type: zod_1.z .enum(['ALL', 'PERSONAL', 'ROLE']) .describe('审批人类型 Options:ALL(全企业),PERSONAL(指定审批人),ROLE(指定角色)') .optional(), id_list: zod_1.z .array(zod_1.z.string()) .describe('ID 列表。- 当 type 取值 ALL 时，无需传值。- 当 type 取值 PERSONAL 时，传入用户 ID，ID 类型与 user_id_type 取值一致。- 当 type 取值 ROLE 时，传入角色 ID。获取方式：成功后，在返回结果中可获取角色 ID') .optional(), })) .describe('发起人自选审批人时，可选择的范围') .optional(), starter_assignee: zod_1.z .enum(['STARTER', 'AUTO_PASS', 'SUPERVISOR', 'DEPARTMENT_MANAGER']) .describe('审批人为提交人本人时的操作 Options:STARTER(提交人本人进行审批),AUTO_PASS(自动通过),SUPERVISOR(提交人的直属上级进行审批),DEPARTMENT_MANAGER(提交人的直属部门负责人进行审批)') .optional(), })) .describe('审批定义节点列表，用于设置审批流程所需要的各个节点，审批流程的始末固定为开始节点和结束节点，因此传值时需要将开始节点作为 list 第一个元素，结束节点作为 list 最后一个元素'), settings: zod_1.z .object({ revert_interval: zod_1.z .number() .describe('审批实例通过后允许撤回的时间，以秒为单位，默认 31 天，取值 0 为不可撤回') .optional(), revert_option: zod_1.z .number() .describe('是否支持审批通过第一个节点后撤回，默认为 1 表示支持，取值为 0 表示不支持') .optional(), reject_option: zod_1.z .number() .describe('审批被拒绝后的设置 Options:0(RejectDefault 默认设置，流程被终止),1(RejectSubmit 退回至发起人，发起人可编辑流程后重新提交)') .optional(), quick_approval_option: zod_1.z .number() .describe('快捷审批配置项，开启后可在卡片上直接审批。**默认值**：1 Options:0(Close 禁用),1(Open 启用)') .optional(), }) .describe('审批定义其他设置') .optional(), config: zod_1.z .object({ can_update_viewer: zod_1.z.boolean().describe('是否允许用户修改可见范围**默认值**：false'), can_update_form: zod_1.z.boolean().describe('是否允许用户更新表单**默认值**：false'), can_update_process: zod_1.z.boolean().describe('是否允许用户更新流程定义**默认值**：false'), can_update_revert: zod_1.z.boolean().describe('是否允许用户更新撤回设置**默认值**：false'), help_url: zod_1.z.string().describe('审批定义的帮助文档链接').optional(), }) .describe('审批定义配置项，用于配置对应审批定义是否可以由用户在进行修改') .optional(), icon: zod_1.z .number() .describe('审批图标枚举，默认为 0。下图从左至右，从上到下依次为 0~24 号图标。 ') .optional(), i18n_resources: zod_1.z .array(zod_1.z.object({ locale: zod_1.z .enum(['zh-CN', 'en-US', 'ja-JP']) .describe('语言。 Options:zh-CN(Zhcn 中文),en-US(Enus 英文),ja-JP(Jajp 日文)'), texts: zod_1.z .array(zod_1.z.object({ key: zod_1.z .string() .describe('文案 key。key 以 `@i18n@` 开头，该字段主要用于做国际化，允许用户同时传多个语言的文案，审批中心会根据用户当前的语音环境使用对应的文案，如果没有传用户当前的语音环境文案，则会使用默认的语言文案'), value: zod_1.z.string().describe('文案内容'), })) .describe('文案的 key、value'), is_default: zod_1.z .boolean() .describe('是否为默认语言。默认语言需要包含所有 key，非默认语言如果 key 不存在会使用默认语言代替'), })) .describe('国际化文案'), process_manager_ids: zod_1.z .array(zod_1.z.string()) .describe('审批流程管理员的用户 ID 列表。- ID 类型与查询参数 user_id_type 取值一致- 列表最大长度为 200') .optional(), }), params: zod_1.z.object({ department_id_type: zod_1.z .enum(['department_id', 'open_department_id']) .describe('此次调用中使用的部门 ID 的类型。关于部门 ID 详细介绍参见。 Options:department_id(DepartmentId 支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。),open_department_id(OpenDepartmentId 由系统自动生成的部门 ID，ID 前缀固定为 `od-`，在租户内全局唯一。)') .optional(), user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional(), }), }, }; exports.approvalV4ApprovalGet = { project: 'approval', name: 'approval.v4.approval.get', sdkName: 'approval.v4.approval.get', path: '/open-apis/approval/v4/approvals/:approval_code', httpMethod: 'GET', description: '[Feishu/Lark]-审批-原生审批定义-查看指定审批定义-根据审批定义 Code 以及语言、用户 ID 等筛选条件获取指定审批定义的信息，包括审批定义名称、状态、表单控件以及节点等信息。获取审批定义信息后，可根据信息构造的请求', accessTokens: ['tenant'], schema: { params: zod_1.z.object({ locale: zod_1.z .enum(['zh-CN', 'en-US', 'ja-JP']) .describe('语言可选值，默认为审批定义配置的默认语言。 Options:zh-CN(Zhcn 中文),en-US(Enus 英文),ja-JP(Jajp 日文)') .optional(), with_admin_id: zod_1.z .boolean() .describe('是否返回有数据管理权限的审批流程管理员 ID 列表（即响应参数 approval_admin_ids）。**默认值**：false') .optional(), user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional(), }), path: zod_1.z.object({ approval_code: zod_1.z .string() .describe('审批定义 Code。获取方式：- 调用接口后，从响应参数 approval_code 获取。- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见'), }), }, }; exports.approvalV4ApprovalSubscribe = { project: 'approval', name: 'approval.v4.approval.subscribe', sdkName: 'approval.v4.approval.subscribe', path: '/open-apis/approval/v4/approvals/:approval_code/subscribe', httpMethod: 'POST', description: '[Feishu/Lark]-审批-审批事件-事件接口-订阅审批事件-当应用后，需要调用该接口指定审批定义 Code（approval_code）开启订阅，开启后应用才可以接收该审批定义对应的事件', accessTokens: ['tenant'], schema: { path: zod_1.z.object({ approval_code: zod_1.z .string() .describe('审批定义 Code。获取方式：- 调用接口后，从响应参数 approval_code 获取。- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见'), }), }, }; exports.approvalV4ApprovalUnsubscribe = { project: 'approval', name: 'approval.v4.approval.unsubscribe', sdkName: 'approval.v4.approval.unsubscribe', path: '/open-apis/approval/v4/approvals/:approval_code/unsubscribe', httpMethod: 'POST', description: '[Feishu/Lark]-审批-审批事件-事件接口-取消订阅审批事件-调用接口订阅审批定义 Code 后，如果不再需要接收该审批定义下的事件订阅通知，可以调用本接口取消订阅审批定义 Code，取消后应用无法再收到该审批定义对应实例的事件通知', accessTokens: ['tenant'], schema: { path: zod_1.z.object({ approval_code: zod_1.z .string() .describe('审批定义 Code。获取方式：- 调用接口后，从响应参数 approval_code 获取。- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见') .optional(), }), }, }; exports.approvalV4ExternalApprovalCreate = { project: 'approval', name: 'approval.v4.externalApproval.create', sdkName: 'approval.v4.externalApproval.create', path: '/open-apis/approval/v4/external_approvals', httpMethod: 'POST', description: '[Feishu/Lark]-审批-三方审批定义-创建三方审批定义-三方审批定义用于设置审批的名称、描述等基本信息，同时还需要设置三方审批系统的审批发起页、数据回调 URL 等信息，将飞书审批与三方审批系统关联起来，使企业员工在飞书审批内即可直接发起三方审批，且审批中心可以将审批数据回传给三方审批系统', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ approval_name: zod_1.z .string() .describe('三方审批定义名称。- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- 该参数需要以 @i18n@ 开头，长度不得少于 9 个字符'), approval_code: zod_1.z .string() .describe('该值用于判断调用当前接口是创建审批定义还是更新审批定义。具体说明：- 如果传入的值系统可以匹配到已存在的审批定义 approval_code，则调用该接口会更新相应的审批定义。- 如果传入的值系统匹配不到任何审批定义 approval_code，则会新建一个审批定义，并返回新建的审批定义真实的 approval_code（并非通过该参数传入的值）'), group_code: zod_1.z .string() .describe('审批定义所属审批分组，用户自定义。具体说明：- 如果传入的 group_code 当前不存在，则会新建审批分组。- 如果 group_code 已经存在，则会使用 group_name 更新审批分组名称'), group_name: zod_1.z .string() .describe('审批分组名称，审批发起页的审批定义分组名称来自该字段。具体说明：- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- 该参数需要以 @i18n@ 开头。- 如果 group_code 当前不存在，则该 group_name 必填，表示新建审批分组时设置分组名称。- 如果 group_code 存在，则会更新分组名称，不填则不更新分组名称') .optional(), description: zod_1.z .string() .describe('审批定义的说明，后续企业员工发起审批时，该说明会在审批发起页展示。 - 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- 该参数需要以 @i18n@ 开头') .optional(), external: zod_1.z .object({ biz_name: zod_1.z .string() .describe('列表中用于提示审批来自哪个三方系统。 **注意**：- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- 该参数需要以 @i18n@ 开头。- 在 i18n_resources 中为该参数赋值时，无需设置 **来自** 前缀，审批中心默认会拼接 **来自** 前缀') .optional(), biz_type: zod_1.z.string().describe('审批定义业务类别，自定义设置').optional(), create_link_mobile: zod_1.z .string() .describe('移动端发起三方审批的链接。- 如果设置了该链接，则在移动端发起审批时，会跳转到该链接对应的三方审批发起页。- 如果不设置该链接，则在移动端不显示该审批') .optional(), create_link_pc: zod_1.z .string() .describe('PC端发起三方审批的链接。 - 如果设置了该链接，则在 PC 端发起审批时，会跳转到该链接对应的三方审批发起页。- 如果不设置该链接，则在 PC 端不显示该审批') .optional(), support_pc: zod_1.z .boolean() .describe('审批定义是否要在 PC 端的发起审批页面展示，如果为 true 则展示，否则不展示。**注意**：support_pc 和 support_mobile 不可都为 false') .optional(), support_mobile: zod_1.z .boolean() .describe('审批定义是否要在移动端的发起审批页面展示，如果为 true 则展示，否则不展示。**注意**：support_pc 和 support_mobile 不可都为 false') .optional(), support_batch_read: zod_1.z.boolean().describe('是否支持批量已读').optional(), enable_mark_readed: zod_1.z.boolean().describe('是否支持标注可读**注意**：该字段无效，暂不支持使用').optional(), enable_quick_operate: zod_1.z.boolean().describe('是否支持快速操作**注意**：该字段无效，暂不支持使用').optional(), action_callback_url: zod_1.z .string() .describe('三方系统的操作回调 URL，**待审批** 实例的任务审批人点击同意或拒绝操作后，审批中心调用该 URL 通知三方系统，回调地址相关信息可参见') .optional(), action_callback_token: zod_1.z.string().describe('回调时带的 token，用于业务系统验证请求来自审批中心').optional(), action_callback_key: zod_1.z .string() .describe('请求参数加密密钥。如果配置了该参数，则会对请求参数进行加密，接收请求后需要对请求进行解密。加解密算法参考') .optional(), allow_batch_operate: zod_1.z .boolean() .describe('是否支持批量审批。取值为 true 时，审批人在处理该定义下的审批任务时可以批量处理多个任务') .optional(), exclude_efficiency_statistics: zod_1.z.boolean().describe('审批流程数据是否不纳入效率统计').optional(), }) .describe('三方审批相关信息'), viewers: zod_1.z .array(zod_1.z.object({ viewer_type: zod_1.z .enum(['TENANT', 'DEPARTMENT', 'USER', 'NONE']) .describe('可见人类型 Options:TENANT(租户内可见),DEPARTMENT(指定部门),USER(指定用户),NONE(任何人都不可见)') .optional(), viewer_user_id: zod_1.z .string() .describe('当 viewer_type 取值为 USER 时，需指定用户 ID。ID 类型与查询参数 user_id_type 取值保持一致') .optional(), viewer_department_id: zod_1.z .string() .describe('当 view_type 取值为 DEPARTMENT 时，需指定部门 ID。ID 类型与查询参数 department_id_type 取值保持一致') .optional(), })) .describe('审批可见人列表，列表长度上限 200，只有在审批可见人列表内的用户，才可以在审批发起页看到该审批。若该参数不传值，则表示任何人不可见') .optional(), i18n_resources: zod_1.z .array(zod_1.z.object({ locale: zod_1.z .enum(['zh-CN', 'en-US', 'ja-JP']) .describe('语言。 Options:zh-CN(Zhcn 中文),en-US(Enus 英文),ja-JP(Jajp 日文)'), texts: zod_1.z .array(zod_1.z.object({ key: zod_1.z.string().describe('文案 Key，需要和各个参数 Key 相匹配'), value: zod_1.z.string().describe('文案 Value，即文案 Key 对应的参数值'), })) .describe('文案的 Key:Value。Key 需要以 @i18n@ 开头，并按照各个参数的要求传入 Value。 **说明**：该字段主要用于适配国际化，允许同时设置多个语言的文案，审批中心会根据实际用户当前的语音环境使用匹配的文案。如果没有设置用户当前的语音环境文案，则会使用默认的语言文案'), is_default: zod_1.z .boolean() .describe('是否为默认语言。默认语言需要包含所有所需的文案 Key，非默认语言如果 Key 不存在，则会使用默认语言代替'), })) .describe('国际化文案') .optional(), managers: zod_1.z .array(zod_1.z.string()) .describe('设置审批流程管理员的用户 ID，最多支持设置 200 个。ID 类型与查询参数 user_id_type 取值一致') .optional(), }), params: zod_1.z.object({ department_id_type: zod_1.z .enum(['department_id', 'open_department_id']) .describe('此次调用中的部门 ID 类型。关于部门 ID 的详细介绍，可参见。 Options:department_id(DepartmentId 支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。),open_department_id(OpenDepartmentId 由系统自动生成的部门 ID，ID 前缀固定为 `od-`，在租户内全局唯一。)') .optional(), user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional(), }), }, }; exports.approvalV4ExternalApprovalGet = { project: 'approval', name: 'approval.v4.externalApproval.get', sdkName: 'approval.v4.externalApproval.get', path: '/open-apis/approval/v4/external_approvals/:approval_code', httpMethod: 'GET', description: '[Feishu/Lark]-审批-三方审批定义-查看指定三方审批定义-调用该接口通过三方审批定义 Code 获取审批定义的详细数据，包括三方审批定义的名称、说明、三方审批发起链接、回调 URL 以及审批定义可见人列表等信息', accessTokens: ['tenant'], schema: { params: zod_1.z.object({ user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional() }), path: zod_1.z.object({ approval_code: zod_1.z .string() .describe('三方审批定义 Code。获取方式：- 调用时，会返回审批定义 Code。- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见'), }), }, }; exports.approvalV4ExternalInstanceCheck = { project: 'approval', name: 'approval.v4.externalInstance.check', sdkName: 'approval.v4.externalInstance.check', path: '/open-apis/approval/v4/external_instances/check', httpMethod: 'POST', description: '[Feishu/Lark]-审批-三方审批实例-校验三方审批实例-调用该接口校验三方审批实例数据，用于判断服务端数据是否为最新的。请求时提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 ID。例如，设置定时任务每隔 5 分钟，将最近 5 分钟产生的实例使用该接口进行对比。如果数据在服务端不存在或者不是最新，则可以根据本接口返回的实例 ID、任务 ID，前往', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ instances: zod_1.z .array(zod_1.z.object({ instance_id: zod_1.z .string() .describe('审批实例 ID。自定义配置，需要确保当前企业、应用内唯一。**注意**：调用本接口和接口操作同一个三方审批实例时，需要确保所用的实例 ID 一致'), update_time: zod_1.z.string().describe('审批实例最近更新时间，Unix 毫秒时间戳'), tasks: zod_1.z .array(zod_1.z.object({ task_id: zod_1.z .string() .describe('审批实例内的审批任务 ID。自定义配置，需要确保当前企业、应用内唯一。**注意**：调用本接口和接口操作同一个三方审批实例内的任务时，需要确保所用的任务 ID 一致'), update_time: zod_1.z.string().describe('任务最近更新时间，Unix 毫秒时间戳'), })) .describe('任务信息'), })) .describe('校验的实例信息'), }), }, }; exports.approvalV4ExternalInstanceCreate = { project: 'approval', name: 'approval.v4.externalInstance.create', sdkName: 'approval.v4.externalInstance.create', path: '/open-apis/approval/v4/external_instances', httpMethod: 'POST', description: '[Feishu/Lark]-审批-三方审批实例-同步三方审批实例-审批中心不负责审批的流转，审批的流转在三方系统。本接口用于把三方系统在审批流转后生成的审批实例、审批任务、审批抄送数据同步到审批中心', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ approval_code: zod_1.z .string() .describe('审批定义 Code。的返回值，用来指定当前实例属于的审批定义。 **说明**：如果在当前接口设置了 title 参数，则审批实例名称按照 title 展示。如果未设置 title，审批实例的标题取自对应审批定义（approval_code）的 name 参数'), status: zod_1.z .enum(['PENDING', 'APPROVED', 'REJECTED', 'CANCELED', 'DELETED', 'HIDDEN', 'TERMINATED']) .describe('审批实例状态 Options:PENDING(审批中),APPROVED(审批流程结束，结果为同意),REJECTED(审批流程结束，结果为拒绝),CANCELED(审批发起人撤回),DELETED(审批被删除),HIDDEN(状态隐藏（不显示状态）),TERMINATED(审批终止)'), extra: zod_1.z .string() .describe('审批实例扩展参数，JSON 格式，传值时需要压缩转义为字符串。单据编号通过传 business_key 参数来实现。**注意**：以下示例值未转义，使用时请注意转义。你可查看请求体示例中转义后的 extra 示例值') .optional(), instance_id: zod_1.z.string().describe('审批实例唯一标识，自定义设置。需确保证在当前企业和应用内唯一'), links: zod_1.z .object({ pc_link: zod_1.z .string() .describe('PC 端的三方审批实例跳转链接。 **说明**： - 当用户使用飞书 PC 端查看实例详情时，通过该链接进行跳转。- pc_link 和 mobile_link 至少填一个'), mobile_link: zod_1.z .string() .describe('移动端的三方审批实例跳转链接。 **说明**： - 当用户使用飞书移动端查看实例详情时，通过该链接进行跳转。- pc_link 和 mobile_link 至少填一个') .optional(), }) .describe('审批实例链接信息。设置的链接用于在审批中心 **已发起** 列表内点击跳转，跳回三方审批系统查看审批详情'), title: zod_1.z .string() .describe('审批展示名称。 **说明**：- 如果填写了该参数，则审批列表中的审批名称使用该参数。如果不填该参数，则审批名称使用审批定义的名称。- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), form: zod_1.z .array(zod_1.z.object({ name: zod_1.z .string() .describe('表单字段名称。 **说明**： - 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), value: zod_1.z .string() .describe('表单值。 **说明**： - 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), })) .describe('用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，最多展示前 3 个，长度不超过 2048 字符。') .optional(), user_id: zod_1.z .string() .describe('审批发起人 user_id。发起人可在审批中心的 **已发起** 列表中看到所有已发起的审批。在 **待办**、**已办**、**抄送我** 列表中，该字段用来展示审批的发起人。获取方式参见。 **注意**：审批发起人的 open_id 和 user_id 需至少传入一个') .optional(), user_name: zod_1.z .string() .describe('审批发起人的用户名。如果发起人不是真实的用户（例如是某个部门），没有 user_id，则可以使用该参数传入一个名称。 **说明**： - 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), open_id: zod_1.z .string() .describe('审批发起人 open_id。发起人可在审批中心的 **已发起** 列表中看到所有已发起的审批。在 **待办**、**已办**、**抄送我** 列表中，该字段用来展示审批的发起人。获取方式参见。 **注意**：审批发起人的 open_id 和 user_id 需至少传入一个') .optional(), department_id: zod_1.z .string() .describe('发起人的部门 ID，用于在审批中心列表中展示发起人的所属部门，不传值则不展示。获取方式参见。 **说明**：如果用户没加入任何部门，传 `""`，默认展示企业名称。如果传入 department_name 参数，则展示对应的部门名称') .optional(), department_name: zod_1.z .string() .describe('审批发起人的部门名称。如果发起人不是真实的用户或没有部门，则可以使用该参数传入部门名称。**说明**： - 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), start_time: zod_1.z.string().describe('审批发起时间，Unix 毫秒时间戳'), end_time: zod_1.z.string().describe('审批实例结束时间。未结束的审批为 0，Unix 毫秒时间戳'), update_time: zod_1.z .string() .describe('审批实例最近更新时间，用于推送数据版本控制。如果 update_mode 值为 UPDATE，则仅当传过来的 update_time 有变化时（变大），才会更新审批中心中的审批实例信息。 **说明**：使用该参数主要用来避免并发时，旧数据更新了新数据'), display_method: zod_1.z .enum(['BROWSER', 'SIDEBAR', 'NORMAL', 'TRUSTEESHIP']) .describe('列表页打开审批实例的方式。 Options:BROWSER(跳转系统默认浏览器打开),SIDEBAR(飞书中侧边抽屉打开),NORMAL(飞书内嵌页面打开),TRUSTEESHIP(以托管打开（即托管在飞书审批中心打开）)') .optional(), update_mode: zod_1.z .enum(['REPLACE', 'UPDATE']) .describe('更新方式。 - 当 update_mode 取值为 REPLACE 时，每次都以当前推送的数据为最终数据，会删掉审批中心中，不在本次推送数据中的多余的任务、抄送数据。- 当 update_mode 取值为 UPDATE 时，不会删除审批中心的数据，而只进行新增、更新实例与任务数据。**默认值**：REPLACE Options:REPLACE(全量替换),UPDATE(增量更新)') .optional(), task_list: zod_1.z .array(zod_1.z.object({ task_id: zod_1.z.string().describe('审批实例内，审批任务的唯一标识，用于更新审批任务时定位数据'), user_id: zod_1.z .string() .describe('审批人 user_id，获取方式参见。 **说明**： - 该任务会出现在审批人的飞书审批中心 **待办** 或 **已办** 的列表中。- user_id 与 open_id 需至少传入一个') .optional(), open_id: zod_1.z .string() .describe('审批人 open_id，获取方式参见。 **说明**： - 该任务会出现在审批人的飞书审批中心 **待办** 或 **已办** 的列表中。- user_id 与 open_id 需至少传入一个') .optional(), title: zod_1.z .string() .describe('审批任务名称。 **说明**：- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), links: zod_1.z .object({ pc_link: zod_1.z .string() .describe('PC 端的跳转链接。 **说明**： - 当用户使用飞书 PC 端查看任务详情时，通过该链接进行跳转。- pc_link 和 mobile_link 至少填一个'), mobile_link: zod_1.z .string() .describe('移动端的跳转链接。 **说明**： - 当用户使用飞书移动端查看任务详情时，通过该链接进行跳转。- pc_link 和 mobile_link 至少填一个') .optional(), }) .describe('在审批中心 **待办**、**已办** 中使用的三方审批跳转链接，用于跳转回三方审批系统查看任务详情'), status: zod_1.z .enum(['PENDING', 'APPROVED', 'REJECTED', 'TRANSFERRED', 'DONE']) .describe('任务状态 Options:PENDING(待审批),APPROVED(任务同意),REJECTED(Reject 任务拒绝),TRANSFERRED(Transefrred 任务转交),DONE(任务通过但审批人未操作。审批人看不到该任务时，如需查看可抄送至该审批人。)'), extra: zod_1.z .string() .describe('扩展字段。JSON 格式，传值时需要压缩转义为字符串。任务结束原因需传 complete_reason 参数，枚举值说明： - approved：同意 - rejected：拒绝 - node_auto_reject：因逻辑判断产生的自动拒绝 - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人） - add：并加签（添加新审批人，与我一起审批） - add_pre：前加签（添加新审批人，在我之前审批） - add_post：后加签（添加新审批人，在我之后审批） - delete_assignee：减签 - forward: 手动转交 - forward_resign：离职自动转交 - recall：撤销（撤回单据，单据失效） - delete ：删除审批单 - admin_forward：管理员在后台操作转交 - system_forward：系统自动转交 - auto_skip：自动通过 - manual_skip：手动跳过 - submit_again：重新提交任务 - restart：重新启动流程 - others：其他') .optional(), create_time: zod_1.z.string().describe('任务创建时间，Unix 毫秒时间戳'), end_time: zod_1.z.string().describe('任务完成时间。未结束的审批为 0，Unix 毫秒时间戳'), update_time: zod_1.z .string() .describe('任务最近更新时间，用于推送数据版本控制。如果 update_mode 值为 UPDATE，则仅当传过来的 update_time 有变化时（变大），才会更新审批中心中的审批任务信息') .optional(), action_context: zod_1.z .string() .describe('操作上下文。当用户操作审批时，回调请求中会包含该参数，用于传递该任务的上下文数据') .optional(), action_configs: zod_1.z .array(zod_1.z.object({ action_type: zod_1.z .string() .describe('操作类型。每个任务都可以配置两个操作（同意、拒绝或任意中的两个），操作会展示审批列表中。当用户操作时，回调请求会包含该字段，三方审批可接受到审批人的操作数据。**可选值有**：<md-enum><md-enum-item key="APPROVE" >同意</md-enum-item><md-enum-item key="REJECT" >拒绝</md-enum-item><md-enum-item key="{KEY}" >任意字符串。如果使用任意字符串，则需要提供 action_name</md-enum-item></md-enum>'), action_name: zod_1.z .string() .describe('操作名称。如果 action_type 不等于 APPROVAL 或 REJECT，则必须提供该字段，用于展示特定的操作名称。 **说明**： - 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), is_need_reason: zod_1.z .boolean() .describe('是否需要审批意见。取值为 true 时，审批人在审批中心操作任务后，还需要跳转填写审批意见') .optional(), is_reason_required: zod_1.z.boolean().describe('审批意见是否必填').optional(), is_need_attachment: zod_1.z.boolean().describe('审批意见是否支持上传附件').optional(), })) .describe('任务级别的快捷审批操作配置。 **注意**：快捷审批目前仅支持在飞书移动端操作') .optional(), display_method: zod_1.z .enum(['BROWSER', 'SIDEBAR', 'NORMAL', 'TRUSTEESHIP']) .describe('审批中心列表页打开审批任务的方式。 Options:BROWSER(跳转系统默认浏览器打开),SIDEBAR(Sidbar 飞书中侧边抽屉打开),NORMAL(飞书内嵌页面打开),TRUSTEESHIP(以托管模式打开)') .optional(), exclude_statistics: zod_1.z .boolean() .describe('三方审批任务是否不纳入效率统计。可选值有：- true：不纳入效率统计- false：纳入效率统计') .optional(), node_id: zod_1.z .string() .describe('审批节点 ID。必须同时满足：- 一个审批流程内，每个节点 ID 唯一。例如，一个流程下直属上级、隔级上级等节点的 node_id 均不一样。- 同一个三方审批定义内，不同审批实例中的相同节点，node_id 要保持不变。例如，用户 A 和用户 B 分别发起了请假申请，这两个审批实例中的直属上级节点的 node_id 应该保持一致') .optional(), node_name: zod_1.z .string() .describe('节点名称。**说明**： - 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。- Key 需要以 @i18n@ 开头') .optional(), })) .describe('任务列表') .optional(), cc_list: zod_1.z .array(zod_1.z.object({ cc_id: zod_1.z.string().describe('审批实例内抄送唯一标识'), user_id: zod_1.z .string() .describe('抄送人的 user_id。获取方式参见。 **注意**：抄送人的 open_id 和 user_id 需至少传入一个') .optional(), open_id: zod_1.z .string() .describe('抄送人的 open_id。获取方式参见。 **注意**：抄送人的 open_id 和 user_id 需至少传入一个') .optional(), links: zod_1.z .object({ pc_link: zod_1.z .string() .describe('PC 端的三方审批实例跳转链接。 **说明**： - 当用户使用飞书 PC 端查看审批抄送时，通过该字段进行跳转。- pc_link 和 mobile_link 至少填一个'), mobile_link: zod_1.z .string() .describe('移动端的三方审批实例跳转链接。 **说明**： - 当用户使用飞书移动端查看审批抄送时，通过该字段进行跳转。- pc_link 和 mobile_link 至少填一个') .optional(), }) .describe('审批抄送跳转链接。设置的链接用于在审批中心 **抄送我** 列表内点击跳转，跳回三方审批系统查看审批抄送详情'), read_status: zod_1.z .enum(['READ', 'UNREAD']) .describe('抄送人的阅读状态，空值表示不支持已读未读。 Options:READ(已读),UNREAD(未读)'), extra: zod_1.z.string().describe('扩展字段。JSON 格式，传值时需要压缩转义为字符串').optional(), title: zod_1.z.string().describe('抄送任务名称').optional(), create_time: zod_1.z.string().describe('抄送发起时间，Unix 毫秒时间戳'), update_time: zod_1.z .string() .describe('抄送最近更新时间，用于推送数据版本。如果 update_mode 值为 UPDATE，则仅当传过来的 update_time 有变化时（变大），才会更新审批中心中的审批实例信息'), display_method: zod_1.z .enum(['BROWSER', 'SIDEBAR', 'NORMAL', 'TRUSTEESHIP']) .describe('列表页打开审批任务的方式。 Options:BROWSER(跳转系统默认浏览器打开),SIDEBAR(飞书中侧边抽屉打开),NORMAL(飞书内嵌页面打开),TRUSTEESHIP(以托管模式打开)') .optional(), })) .describe('抄送列表') .optional(), i18n_resources: zod_1.z .array(zod_1.z.object({ locale: zod_1.z .enum(['zh-CN', 'en-US', 'ja-JP']) .describe('语言 Options:zh-CN(Zhcn 中文),en-US(Enus 英文),ja-JP(Jajp 日文)'), texts: zod_1.z .array(zod_1.z.object({ key: zod_1.z.string().describe('文案 Key，需要和各个参数 Key 相匹配'), value: zod_1.z.string().describe('文案 Value，即文案 Key 对应的参数值'), })) .describe('文案的 Key:Value。Key 需要以 @i18n@ 开头，并按照各个参数的要求传入 Value。该字段主要用于做国际化，允许用户同时传多个语言的文案，审批中心会根据用户当前的语音环境使用对应的文案，如果没有传用户当前的语音环境文案，则会使用默认的语言文案'), is_default: zod_1.z .boolean() .describe('是否为默认语言。默认语言需要包含所有所需的文案 Key，非默认语言如果 Key 不存在，则会使用默认语言代替'), })) .describe('国际化文案'), trusteeship_url_token: zod_1.z.string().describe('单据托管认证 token，托管回调会附带此 token，帮助业务认证').optional(), trusteeship_user_id_type: zod_1.z .string() .describe('用户的类型，会影响请求参数用户标识域的选择，包括加签操作回传的目标用户，目前仅支持 user_id') .optional(), trusteeship_urls: zod_1.z .object({ form_detail_url: zod_1.z.string().describe('获取表单 schema 相关数据的 URL 地址').optional(), action_definition_url: zod_1.z.string().describe('表示获取审批操作区数据的 URL 地址').optional(), approval_node_url: zod_1.z.string().describe('获取审批记录相关数据的 URL 地址').optional(), action_callback_url: zod_1.z.string().describe('进行审批操作时回调的 URL 地址').optional(), pull_business_data_url: zod_1.z .string() .describe('获取托管动态数据 URL 地址。使用该接口时，必须要保证历史托管单据的数据中都同步了该接口地址。如果历史单据中没有该接口，需要重新同步历史托管单据的数据来更新该 URL。该接口用于飞书审批前端和业务进行交互使用，只有使用审批前端的特定组件（由飞书审批前端提供的组件，并且需要和业务进行接口交互的组件）才会需要') .optional(), }) .describe('单据托管回调接入方的接口 URL 地址') .optional(), trusteeship_cache_config: zod_1.z .object({ form_policy: zod_1.z .enum(['DISABLE', 'IMMUTABLE', 'BY_NODE', 'BY_USER']) .describe('托管预缓存策略。 Options:DISABLE(不启用，默认),IMMUTABLE(表单不会随流程进行改变),BY_NODE(ByNode 跟随流程节点变更更新缓存),BY_USER(ByUser 对于每个待办任务存储一份)') .optional(), form_vary_with_locale: zod_1.z.boolean().describe('表单是否随国际化改变').optional(), form_version: zod_1.z .string() .describe('当前使用的表单版本号，保证表单改变后，版本号增加，实际值为 int64 整数') .optional(), }) .describe('托管预缓存策略') .optional(), }), }, }; exports.approvalV4ExternalTaskList = { project: 'approval', name: 'approval.v4.externalTask.list', sdkName: 'approval.v4.externalTask.list', path: '/open-apis/approval/v4/external_tasks', httpMethod: 'GET', description: '[Feishu/Lark]-审批-三方审批任务-获取三方审批任务状态-该接口用于获取三方审批的状态。用户传入查询条件，接口返回满足条件的审批实例的状态', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ approval_codes: zod_1.z.array(zod_1.z.string()).describe('审批定义 Code，用于指定只获取这些定义下的数据').optional(), instance_ids: zod_1.z .array(zod_1.z.string()) .describe('审批实例 ID, 用于指定只获取这些实例下的数据，最多支持 20 个') .optional(), user_ids: zod_1.z.array(zod_1.z.string()).describe('审批人 user_id，用于指定只获取这些用户的数据').optional(), status: zod_1.z .enum(['PENDING', 'APPROVED', 'REJECTED', 'TRANSFERRED', 'DONE']) .describe('审批任务状态，用于指定获取该状态下的数据 Options:PENDING(审批中),APPROVED(审批流程结束，结果为同意),REJECTED(审批流程结束，结果为拒绝),TRANSFERRED(任务转交),DONE(任务通过但审批人未操作；审批人看不到这个任务, 若想要看到, 可以通过抄送该人.)') .optional(), }), params: zod_1.z.object({ page_size: zod_1.z.number().describe('分页大小').optional(), page_token: zod_1.z .string() .describe('分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果') .optional(), }), }, }; exports.approvalV4InstanceAddSign = { project: 'approval', name: 'approval.v4.instance.addSign', sdkName: 'approval.v4.instance.addSign', path: '/open-apis/approval/v4/instances/add_sign', httpMethod: 'POST', description: '[Feishu/Lark]-审批-原生审批任务-审批任务加签', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ user_id: zod_1.z.string().describe('操作用户id'), approval_code: zod_1.z.string().describe('审批定义code'), instance_code: zod_1.z.string().describe('审批实例code'), task_id: zod_1.z.string().describe('任务id'), comment: zod_1.z.string().describe('意见').optional(), add_sign_user_ids: zod_1.z.array(zod_1.z.string()).describe('被加签人id'), add_sign_type: zod_1.z .number() .describe('1/2/3分别代表前加签/后加签/并加签 Options:1(add_sign_pre 前加签),2(add_sign_post 后加签),3(add_sign_parallel 并加签)'), approval_method: zod_1.z .number() .describe('仅在前加签、后加签时需要填写，1/2 分别代表或签/会签 Options:1(or_sign 或签),2(add_sign 会签),3(sequential_sign 依次审批)') .optional(), }), }, }; exports.approvalV4InstanceCancel = { project: 'approval', name: 'approval.v4.instance.cancel', sdkName: 'approval.v4.instance.cancel', path: '/open-apis/approval/v4/instances/cancel', httpMethod: 'POST', description: '[Feishu/Lark]-审批-原生审批实例-撤回审批实例-如果企业管理员在审批后台的某一审批定义的 **更多设置** 中，勾选了 **允许撤销审批中的申请** 或者 **允许撤销 x 天内通过的审批**，则在符合撤销规则的情况下，你可以调用本接口将指定提交人的审批实例撤回', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ approval_code: zod_1.z .string() .describe('审批定义 Code。获取方式：- 调用接口后，从响应参数 approval_code 获取。- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见'), instance_code: zod_1.z .string() .describe('审批实例 Code。获取方式：- 后，从返回结果中获取审批实例 Code。- 调用，获取指定审批定义内的审批实例 Code。- 调用，设置过滤条件查询指定的审批实例 Code'), user_id: zod_1.z.string().describe('审批提交人的用户 ID，ID 类型与查询参数 user_id_type 的取值一致'), }), params: zod_1.z.object({ user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional() }), }, }; exports.approvalV4InstanceCc = { project: 'approval', name: 'approval.v4.instance.cc', sdkName: 'approval.v4.instance.cc', path: '/open-apis/approval/v4/instances/cc', httpMethod: 'POST', description: '[Feishu/Lark]-审批-原生审批实例-抄送审批实例-调用该接口将当前审批实例抄送给指定用户。被抄送的用户可以查看审批实例详情。例如，在飞书客户端的 **工作台 > 审批 > 审批中心 > 抄送我** 列表中查看到审批实例', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ approval_code: zod_1.z .string() .describe('审批定义 Code。获取方式：- 调用接口后，从响应参数 approval_code 获取。- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见'), instance_code: zod_1.z .string() .describe('审批实例 Code。获取方式：- 后，从返回结果中获取审批实例 Code。- 调用，获取指定审批定义内的审批实例 Code。- 调用，设置过滤条件查询指定的审批实例 Code'), user_id: zod_1.z.string().describe('发起当前操作的用户 ID，ID 类型与查询参数 user_id_type 取值一致'), cc_user_ids: zod_1.z.array(zod_1.z.string()).describe('抄送人的用户 ID 列表，ID 类型与查询参数 user_id_type 取值一致'), comment: zod_1.z.string().describe('抄送留言').optional(), }), params: zod_1.z.object({ user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional() }), }, }; exports.approvalV4InstanceCommentCreate = { project: 'approval', name: 'approval.v4.instanceComment.create', sdkName: 'approval.v4.instanceComment.create', path: '/open-apis/approval/v4/instances/:instance_id/comments', httpMethod: 'POST', description: '[Feishu/Lark]-审批-原生审批评论-创建评论-在指定审批实例下创建、修改评论或回复评论（不包含审批同意、拒绝、转交等附加的理由或意见）', accessTokens: ['tenant'], schema: { data: zod_1.z.object({ content: zod_1.z .string() .describe('评论内容，JSON 格式，传入时需要压缩转义为字符串。以下示例值未转义，你可参考请求体示例中的示例 content 进行编辑。**JSON 内参数说明**：- text：string 类型，评论文本内容。- files：Attachment[] 类型，附件信息。 - url：string 类型，附件链接。 - thumbnailURL：string 类型，缩略图链接。 - fileSize：int64 类型，文件大小。 - title：string 类型，标题。 - type：string 类型，附件类型，取值 image 表示图片类型。**注意**：- 如需 @用户，则需要在该参数内设置用户名的文本，例如 `@username`，同时通过 at_info_list 参数实现 @ 效果。- 对于附件，在 PC 端使用 HTTP 资源链接传图片资源可能会导致缩略图异常，建议使用 HTTPS 传资源附件') .optional(), at_info_list: zod_1.z .array(zod_1.z.object({ user_id: zod_1.z.string().describe('被艾特人的 ID，ID 类型与查询参数 user_id_type 取值一致'), name: zod_1.z.string().describe('被艾特人的姓名'), offset: zod_1.z .string() .describe('被艾特人在评论中的位置，从 0 开始。用于偏移覆盖。例如：- 取值为 0 时的效果：@username 示例文本- 取值为 2 时的效果：示例 @username 文本- 取值为 4 时的效果：示例文本 @username **注意**：该参数生效方式是覆盖生效，因此你需要先通过 content 参数设置用户名称的文本内容，然后再通过该参数将实际生效的@效果覆盖到用户名称的文本内容上'), })) .describe('评论中艾特人信息') .optional(), parent_comment_id: zod_1.z .string() .describe('父评论 ID，如果是回复评论，需要传入该值。获取方式：- 调用当前接口成功后会返回本次评论的 ID，你可以保存用于下次使用。- 调用接口，获取评论 ID') .optional(), comment_id: zod_1.z .string() .describe('评论 ID。如果需要编辑、删除一条评论，则需要将该评论的 ID 传入当前参数。获取方式：- 调用当前接口成功后会返回本次评论的 ID，你可以保存用于下次使用。- 调用接口，获取评论 ID') .optional(), disable_bot: zod_1.z .boolean() .describe('是否不启用 Bot，取值为 true 时只同步数据，不触发 Bot。**说明**：飞书审批中自定义审批填写 false，其他情况填写 true') .optional(), extra: zod_1.z.string().describe('附加字段，JSON 格式，传入时需要压缩转义为字符串').optional(), }), params: zod_1.z.object({ user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional(), user_id: zod_1.z.string().describe('用户 ID，ID 类型与 user_id_type 取值一致'), }), path: zod_1.z.object({ instance_id: zod_1.z .string() .describe('审批实例 Code。获取方式：- 后，从返回结果中获取审批实例 Code。- 调用，获取指定审批定义内的审批实例 Code。- 调用，设置过滤条件查询指定的审批实例 Code。说明：支持传入自定义审批实例 ID'), }), }, }; exports.approvalV4InstanceCommentDelete = { project: 'approval', name: 'approval.v4.instanceComment.delete', sdkName: 'approval.v4.instanceComment.delete', path: '/open-apis/approval/v4/instances/:instance_id/comments/:comment_id', httpMethod: 'DELETE', description: '[Feishu/Lark]-审批-原生审批评论-删除评论-删除某审批实例下的一条评论或评论回复（不包含审批同意、拒绝、转交等附加的理由或意见），删除后在审批中心的审批实例内不再显示评论内容，而是显示 **评论已删除**', accessTokens: ['tenant'], schema: { params: zod_1.z.object({ user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional(), user_id: zod_1.z.string().describe('用户 ID，ID 类型与 user_id_type 取值一致'), }), path: zod_1.z.object({ instance_id: zod_1.z .string() .describe('审批实例 Code。获取方式：- 后，从返回结果中获取审批实例 Code。- 调用，获取指定审批定义内的审批实例 Code。- 调用，设置过滤条件查询指定的审批实例 Code。说明：支持传入自定义审批实例 ID'), comment_id: zod_1.z .string() .describe('评论 ID。获取方式：- 调用成功会返回评论 ID。- 调用接口，获取评论 ID'), }), }, }; exports.approvalV4InstanceCommentList = { project: 'approval', name: 'approval.v4.instanceComment.list', sdkName: 'approval.v4.instanceComment.list', path: '/open-apis/approval/v4/instances/:instance_id/comments', httpMethod: 'GET', description: '[Feishu/Lark]-审批-原生审批评论-获取评论-根据审批实例 Code 获取某个审批实例下，全部评论与评论回复（不包含审批同意、拒绝、转交等附加的理由或意见）', accessTokens: ['tenant'], schema: { params: zod_1.z.object({ user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional(), user_id: zod_1.z.string().describe('用户 ID，ID 类型与 user_id_type 取值一致'), page_token: zod_1.z .string() .describe('分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果') .optional(), page_size: zod_1.z.number().describe('分页大小，用于限制一次请求返回的数据量上限').optional(), }), path: zod_1.z.object({ instance_id: zod_1.z .string() .describe('审批实例 Code。获取方式：- 后，从返回结果中获取审批实例 Code。- 调用，获取指定审批定义内的审批实例 Code。- 调用，设置过滤条件查询指定的审批实例 Code。**说明**：支持传入自定义审批实例 ID'), }), }, }; exports.approvalV4InstanceCommentRemove = { project: 'approval', name: 'approval.v4.instanceComment.remove', sdkName: 'approval.v4.instanceComment.remove', path: '/open-apis/approval/v4/instances/:instance_id/comments/remove', httpMethod: 'POST', description: '[Feishu/Lark]-审批-原生审批评论-清空评论-清空某审批实例下的全部评论与评论回复，包括显示为已删除的评论', accessTokens: ['tenant'], schema: { params: zod_1.z.object({ user_id_type: zod_1.z.enum(['open_id', 'union_id', 'user_id']).describe('用户ID类型').optional(), user_id: zod_1.z.string().describe('用户 ID，ID 类型与 user_id_type 取值一致').optional(), }), path: zod_1.z.object({ instance_id: zod_1.z .string() .describe('审批实例 Code。获取方式：- 后，从返回结果中获取审批实例 Code。- 调用，获取指定审批定义内的审批实例 Code。- 调用，设置过滤条件查询指定的审批实例 Code。**说明**：支持传入自定义审批实例 ID'), }), }, }; exports.approvalV4InstanceCreate = { project: 'approval', name: 'approval.v4.instance.create', sdkName: 'approval.v4.instance.create', path: '/open-apis/approval/v4/instances', httpMethod: 'POST', description: '[Feishu/Lark]-审批-原生审批实例-创