@satorijs/adapter-lark 3.11.8 → 3.12.0

package/src/types/directory.ts

@@ -24,7 +24,7 @@ export namespace Directory {
        */
       create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>
       /**
-       * 更新员工
+       * 更新员工信息
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/employee/patch
        */
       patch(employee_id: string, body: PatchRequest, query?: PatchQuery): Promise<void>
@@ -59,15 +59,10 @@ export namespace Directory {
        */
       filter(body: FilterRequest, query?: FilterQuery): Promise<FilterResponse>
       /**
-       * 搜索员工
+       * 搜索员工信息
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/employee/search
        */
       search(body: SearchRequest, query?: SearchQuery): Promise<SearchResponse>
-      /**
-       * 转换员工 ID
-       * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/employee/idconvert
-       */
-      idconvert(body: IdconvertRequest, query?: IdconvertQuery): Promise<IdconvertResponse>
     }
 
     export interface CreateRequest {
@@ -214,23 +209,6 @@ export namespace Directory {
       /** 字段异常信息 */
       abnormals?: Lark.AbnormalRecord[]
     }
-
-    export interface IdconvertRequest {
-      /** 用户ID列表 */
-      employee_ids: string[]
-    }
-
-    export interface IdconvertQuery {
-      /** 员工ID类型 */
-      employee_id_type?: 'open_id' | 'union_id' | 'employee_id'
-    }
-
-    export interface IdconvertResponse {
-      /** id转换结果列表 */
-      id_convert_results?: Lark.EmployeeIdConvertResult[]
-      /** 异常信息列表 */
-      abnormals?: Lark.AbnormalRecord[]
-    }
   }
 
   export namespace Department {
@@ -256,7 +234,7 @@ export namespace Directory {
        */
       mget(body: MgetRequest, query?: MgetQuery): Promise<MgetResponse>
       /**
-       * 批量获取部门列表
+       * 获取部门列表
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/department/filter
        */
       filter(body: FilterRequest, query?: FilterQuery): Promise<FilterResponse>
@@ -265,11 +243,6 @@ export namespace Directory {
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/department/search
        */
       search(body: SearchRequest, query?: SearchQuery): Promise<SearchResponse>
-      /**
-       * 转换部门 ID
-       * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/department/idconvert
-       */
-      idconvert(body: IdconvertRequest, query?: IdconvertQuery): Promise<IdconvertResponse>
     }
 
     export interface CreateRequest {
@@ -376,23 +349,6 @@ export namespace Directory {
       /** 字段异常信息 */
       abnormals?: Lark.AbnormalRecord[]
     }
-
-    export interface IdconvertRequest {
-      /** 部门ID列表 */
-      department_ids: string[]
-    }
-
-    export interface IdconvertQuery {
-      /** 部门ID类型 */
-      department_id_type?: 'department_id' | 'open_department_id'
-    }
-
-    export interface IdconvertResponse {
-      /** id转换结果列表 */
-      id_convert_results?: Lark.DepartmentIdConvertResult[]
-      /** 异常信息列表 */
-      abnormals?: Lark.AbnormalRecord[]
-    }
   }
 
   export namespace CollborationShareEntity {
@@ -530,9 +486,6 @@ Internal.define({
   '/directory/v1/employees/search': {
     POST: 'directory.employee.search',
   },
-  '/directory/v1/employees/idconvert': {
-    POST: 'directory.employee.idconvert',
-  },
   '/directory/v1/departments': {
     POST: 'directory.department.create',
   },
@@ -549,9 +502,6 @@ Internal.define({
   '/directory/v1/departments/search': {
     POST: 'directory.department.search',
   },
-  '/directory/v1/departments/idconvert': {
-    POST: 'directory.department.idconvert',
-  },
   '/directory/v1/share_entities': {
     GET: 'directory.collborationShareEntity.list',
   },

package/src/types/docx.ts

@@ -208,6 +208,11 @@ export namespace Docx {
        * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/raw_content
        */
       rawContent(document_id: string, query?: RawContentQuery): Promise<RawContentResponse>
+      /**
+       * Markdown/HTML 内容转换为文档块
+       * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/convert
+       */
+      convert(body: ConvertRequest, query?: ConvertQuery): Promise<ConvertResponse>
     }
 
     export interface CreateRequest {
@@ -246,6 +251,27 @@ export namespace Docx {
       content?: string
     }
 
+    export interface ConvertRequest {
+      /** 内容类型 */
+      content_type: 'markdown' | 'html'
+      /** 文本内容 */
+      content: string
+    }
+
+    export interface ConvertQuery {
+      /** 此次调用中使用的用户ID的类型 */
+      user_id_type?: 'user_id' | 'union_id' | 'open_id'
+    }
+
+    export interface ConvertResponse {
+      /** 第一级 Block 对应的临时 ID 列表， index 代表了 Block 的顺序 */
+      first_level_block_ids?: string[]
+      /** 带有父子关系的 Block 列表 */
+      blocks?: Lark.Block[]
+      /** 如果要转换的内容中带有图片，这里记录了临时 Block ID 和 Image URL 的对应关系 */
+      block_id_to_image_urls?: Lark.BlockIdToImageUrl[]
+    }
+
     export namespace Block {
       export interface Methods {
         children: Children.Methods
@@ -531,4 +557,7 @@ Internal.define({
   '/docx/v1/documents/{document_id}/blocks/{block_id}/children/batch_delete': {
     DELETE: 'docx.document.block.children.batchDelete',
   },
+  '/docx/v1/documents/blocks/convert': {
+    POST: 'docx.document.convert',
+  },
 })

package/src/types/drive.ts

@@ -211,7 +211,10 @@ export namespace Drive {
       file_name: string
       /** 上传点类型。 */
       parent_type: 'explorer'
-      /** 文件夹token，获取方式见 [概述](/ssl:ttdoc/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) */
+      /**
+       * 文件夹token，
+       * 获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction)
+       */
       parent_node: string
       /** 文件大小（以字节为单位）。 */
       size: number
@@ -958,104 +961,41 @@ export namespace Drive {
 
     export namespace Member {
       export interface Methods {
+        /**
+         * 增加协作者权限
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create
+         */
+        create(token: string, body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>
         /**
          * 批量增加协作者权限
          * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/batch_create
          */
         batchCreate(token: string, body: BatchCreateRequest, query?: BatchCreateQuery): Promise<BatchCreateResponse>
         /**
-         * 转移所有者
-         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/transfer_owner
-         */
-        transferOwner(token: string, body: TransferOwnerRequest, query?: TransferOwnerQuery): Promise<void>
-        /**
-         * 判断当前用户是否有某权限
-         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/auth
+         * 更新协作者权限
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/update
          */
-        auth(token: string, query?: AuthQuery): Promise<AuthResponse>
+        update(token: string, member_id: string, body: UpdateRequest, query?: UpdateQuery): Promise<UpdateResponse>
         /**
-         * 获取协作者列表
+         * 获取云文档协作者
          * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/list
          */
         list(token: string, query?: ListQuery): Promise<ListResponse>
         /**
-         * 增加协作者权限
-         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create
+         * 移除云文档协作者权限
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/delete
          */
-        create(token: string, body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>
+        delete(token: string, member_id: string, body: DeleteRequest, query?: DeleteQuery): Promise<void>
         /**
-         * 更新协作者权限
-         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/update
+         * 转移云文档所有者
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/transfer_owner
          */
-        update(token: string, member_id: string, body: UpdateRequest, query?: UpdateQuery): Promise<UpdateResponse>
+        transferOwner(token: string, body: TransferOwnerRequest, query?: TransferOwnerQuery): Promise<void>
         /**
-         * 移除协作者权限
-         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/delete
+         * 判断用户云文档权限
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/auth
          */
-        delete(token: string, member_id: string, body: DeleteRequest, query?: DeleteQuery): Promise<void>
-      }
-
-      export interface BatchCreateRequest {
-        /** 协作者列表 */
-        members: Lark.BaseMember[]
-      }
-
-      export interface BatchCreateQuery {
-        /** 文件的类型 */
-        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'folder' | 'mindnote' | 'minutes' | 'slides'
-        /** 添加权限后是否通知对方 */
-        need_notification?: boolean
-      }
-
-      export interface BatchCreateResponse {
-        /** 协作者列表 */
-        members?: Lark.BaseMember[]
-      }
-
-      export interface TransferOwnerRequest {
-        /** 文档拥有者的ID类型 */
-        member_type: 'email' | 'openid' | 'userid'
-        /** 文档拥有者的ID，与文档拥有者的ID类型需要对应 */
-        member_id: string
-      }
-
-      export interface TransferOwnerQuery {
-        /** 文件类型，需要与文件的 token 相匹配 */
-        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides' | 'folder'
-        /** 是否需要通知新 Owner */
-        need_notification?: boolean
-        /** 转移后是否需要移除原 Owner 的权限 */
-        remove_old_owner?: boolean
-        /** 仅当内容不在共享文件夹中，此参数才会生效。如果设为false，系统会将该内容移至新所有者的个人空间根文件夹。如果设为 true，则留在原位置。 */
-        stay_put?: boolean
-        /** 仅当 remove_old_owner = false 时，此参数才会生效 保留原文件所有者指定的权限角色 */
-        old_owner_perm?: string
-      }
-
-      export interface AuthQuery {
-        /** 文件类型，需要与文件的 token 相匹配 */
-        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides'
-        /** 需要判断的权限 */
-        action: 'view' | 'edit' | 'share' | 'comment' | 'export' | 'copy' | 'print' | 'manage_public'
-      }
-
-      export interface AuthResponse {
-        /** 是否有权限 */
-        auth_result: boolean
-      }
-
-      export interface ListQuery {
-        /** 文件类型，需要与文件的 token 相匹配 */
-        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides'
-        /** 指定返回的协作者字段信息，如无指定则默认不返回**可选值有：** - `name`：协作者名- `type`：协作者类型- `avatar`：头像- `external_label`：外部标签**注意：** - 你可以使用特殊值`*`指定返回目前支持的所有字段- 你可以使用`,`分隔若干个你想指定返回的字段，如：`name,avatar`- 按需指定返回字段接口性能更好 */
-        fields?: string
-        /** 协作者的权限角色类型 */
-        perm_type?: 'container' | 'single_page'
-      }
-
-      export interface ListResponse {
-        /** 返回的列表数据 */
-        items?: Lark.Member[]
+        auth(token: string, query?: AuthQuery): Promise<AuthResponse>
       }
 
       export interface CreateRequest {
@@ -1083,6 +1023,23 @@ export namespace Drive {
         member?: Lark.BaseMember
       }
 
+      export interface BatchCreateRequest {
+        /** 协作者列表 */
+        members: Lark.BaseMember[]
+      }
+
+      export interface BatchCreateQuery {
+        /** 文件的类型 */
+        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'folder' | 'mindnote' | 'minutes' | 'slides'
+        /** 添加权限后是否通知对方 */
+        need_notification?: boolean
+      }
+
+      export interface BatchCreateResponse {
+        /** 协作者列表 */
+        members?: Lark.BaseMember[]
+      }
+
       export interface UpdateRequest {
         /** 协作者ID类型 */
         member_type: 'email' | 'openid' | 'unionid' | 'openchat' | 'opendepartmentid' | 'userid' | 'groupid' | 'wikispaceid'
@@ -1095,7 +1052,10 @@ export namespace Drive {
       }
 
       export interface UpdateQuery {
-        /** 更新权限后是否通知对方**注意：** 使用`tenant_access_token`访问不支持该参数 */
+        /**
+         * 更新权限后是否通知对方
+         * **注意：** 使用`tenant_access_token`访问不支持该参数
+         */
         need_notification?: boolean
         /** 文件类型，放于query参数中，如：`?type=doc` */
         type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides'
@@ -1106,6 +1066,31 @@ export namespace Drive {
         member?: Lark.BaseMember
       }
 
+      export interface ListQuery {
+        /** 文件类型，需要与文件的 token 相匹配 */
+        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides'
+        /**
+         * 指定返回的协作者字段信息，如无指定则默认不返回
+         * **可选值有：**
+         * - `name`：协作者名
+         * - `type`：协作者类型
+         * - `avatar`：头像
+         * - `external_label`：外部标签
+         * **注意：**
+         * - 你可以使用特殊值`*`指定返回目前支持的所有字段
+         * - 你可以使用`,`分隔若干个你想指定返回的字段，如：`name,avatar`
+         * - 按需指定返回字段接口性能更好
+         */
+        fields?: string
+        /** 协作者的权限角色类型 */
+        perm_type?: 'container' | 'single_page'
+      }
+
+      export interface ListResponse {
+        /** 返回的列表数据 */
+        items?: Lark.Member[]
+      }
+
       export interface DeleteRequest {
         /** 协作者类型 */
         type?: 'user' | 'chat' | 'department' | 'group' | 'wiki_space_member' | 'wiki_space_viewer' | 'wiki_space_editor'
@@ -1119,31 +1104,53 @@ export namespace Drive {
         /** 权限成员类型，放于query参数中，如：`?member_type=openid` */
         member_type: 'email' | 'openid' | 'openchat' | 'opendepartmentid' | 'userid' | 'unionid' | 'groupid' | 'wikispaceid'
       }
+
+      export interface TransferOwnerRequest {
+        /** 文档拥有者的ID类型 */
+        member_type: 'email' | 'openid' | 'userid'
+        /** 文档拥有者的ID，与文档拥有者的ID类型需要对应 */
+        member_id: string
+      }
+
+      export interface TransferOwnerQuery {
+        /** 文件类型，需要与文件的 token 相匹配 */
+        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides' | 'folder'
+        /** 是否需要通知新 Owner */
+        need_notification?: boolean
+        /** 转移后是否需要移除原 Owner 的权限 */
+        remove_old_owner?: boolean
+        /** 仅当内容不在共享文件夹中，此参数才会生效。如果设为false，系统会将该内容移至新所有者的个人空间根文件夹。如果设为 true，则留在原位置。 */
+        stay_put?: boolean
+        /** 仅当 remove_old_owner = false 时，此参数才会生效 保留原文件所有者指定的权限角色 */
+        old_owner_perm?: string
+      }
+
+      export interface AuthQuery {
+        /** 文件类型，需要与文件的 token 相匹配 */
+        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides'
+        /** 需要判断的权限 */
+        action: 'view' | 'edit' | 'share' | 'comment' | 'export' | 'copy' | 'print' | 'manage_public'
+      }
+
+      export interface AuthResponse {
+        /** 是否有权限 */
+        auth_result: boolean
+      }
     }
 
     export namespace Public {
       export interface Methods {
         password: Password.Methods
-        /**
-         * 获取云文档权限设置
-         * @see https://open.feishu.cn/document/ukTMukTMukTM/uIzNzUjLyczM14iM3MTN/drive-v2/permission-public/get
-         */
-        get(token: string, query?: GetQuery): Promise<GetResponse>
         /**
          * 更新云文档权限设置
          * @see https://open.feishu.cn/document/ukTMukTMukTM/uIzNzUjLyczM14iM3MTN/drive-v2/permission-public/patch
          */
         patch(token: string, body: PatchRequest, query?: PatchQuery): Promise<PatchResponse>
-      }
-
-      export interface GetQuery {
-        /** 文件类型，需要与文件的 token 相匹配 */
-        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides'
-      }
-
-      export interface GetResponse {
-        /** 返回的文档公共设置 */
-        permission_public?: Lark.PermissionPublic
+        /**
+         * 获取云文档权限设置
+         * @see https://open.feishu.cn/document/ukTMukTMukTM/uIzNzUjLyczM14iM3MTN/drive-v2/permission-public/get
+         */
+        get(token: string, query?: GetQuery): Promise<GetResponse>
       }
 
       export interface PatchRequest {
@@ -1173,20 +1180,30 @@ export namespace Drive {
         permission_public?: Lark.PermissionPublic
       }
 
+      export interface GetQuery {
+        /** 文件类型，需要与文件的 token 相匹配 */
+        type: 'doc' | 'sheet' | 'file' | 'wiki' | 'bitable' | 'docx' | 'mindnote' | 'minutes' | 'slides'
+      }
+
+      export interface GetResponse {
+        /** 返回的文档公共设置 */
+        permission_public?: Lark.PermissionPublic
+      }
+
       export namespace Password {
         export interface Methods {
           /**
-           * 开启密码
+           * 启用云文档密码
            * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public-password/create
            */
           create(token: string, query?: CreateQuery): Promise<CreateResponse>
           /**
-           * 刷新密码
+           * 刷新云文档密码
            * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public-password/update
            */
           update(token: string, query?: UpdateQuery): Promise<UpdateResponse>
           /**
-           * 关闭密码
+           * 停用云文档密码
            * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public-password/delete
            */
           delete(token: string, query?: DeleteQuery): Promise<void>
@@ -1320,32 +1337,32 @@ Internal.define({
   '/drive/v1/files/{file_token}/delete_subscribe': {
     DELETE: 'drive.file.deleteSubscribe',
   },
+  '/drive/v1/permissions/{token}/members': {
+    POST: 'drive.permission.member.create',
+    GET: 'drive.permission.member.list',
+  },
   '/drive/v1/permissions/{token}/members/batch_create': {
     POST: 'drive.permission.member.batchCreate',
   },
+  '/drive/v1/permissions/{token}/members/{member_id}': {
+    PUT: 'drive.permission.member.update',
+    DELETE: 'drive.permission.member.delete',
+  },
   '/drive/v1/permissions/{token}/members/transfer_owner': {
     POST: 'drive.permission.member.transferOwner',
   },
   '/drive/v1/permissions/{token}/members/auth': {
     GET: 'drive.permission.member.auth',
   },
-  '/drive/v1/permissions/{token}/members': {
-    GET: 'drive.permission.member.list',
-    POST: 'drive.permission.member.create',
-  },
-  '/drive/v1/permissions/{token}/members/{member_id}': {
-    PUT: 'drive.permission.member.update',
-    DELETE: 'drive.permission.member.delete',
+  '/drive/v2/permissions/{token}/public': {
+    PATCH: 'drive.permission.public.patch',
+    GET: 'drive.permission.public.get',
   },
   '/drive/v1/permissions/{token}/public/password': {
     POST: 'drive.permission.public.password.create',
     PUT: 'drive.permission.public.password.update',
     DELETE: 'drive.permission.public.password.delete',
   },
-  '/drive/v2/permissions/{token}/public': {
-    GET: 'drive.permission.public.get',
-    PATCH: 'drive.permission.public.patch',
-  },
   '/drive/v1/files/{file_token}/comments': {
     GET: { name: 'drive.file.comment.list', pagination: { argIndex: 1 } },
     POST: 'drive.file.comment.create',

package/src/types/ehr.ts

@@ -51,7 +51,11 @@ export namespace Ehr {
     export interface ListQuery extends Pagination {
       /** 返回数据类型 */
       view?: 'basic' | 'full'
-      /** 员工状态，不传代表查询所有员工状态实际在职 = 2&4可同时查询多个状态的记录，如 status=2&status=4 */
+      /**
+       * 员工状态，不传代表查询所有员工状态
+       * 实际在职 = 2&4
+       * 可同时查询多个状态的记录，如 status=2&status=4
+       */
       status?: ListQueryStatus[]
       /** 雇员类型，不传代表查询所有雇员类型 */
       type?: ListQueryType[]
@@ -61,7 +65,12 @@ export namespace Ehr {
       end_time?: string
       /** 此次调用中使用的用户ID的类型 */
       user_id_type?: 'user_id' | 'union_id' | 'open_id'
-      /** user_id、open_id 或 union_id，默认为 open_id。如果传入的值不是 open_id，需要一并传入 user_id_type 参数。可一次查询多个 id 的用户，例如：user_ids=ou_8ebd4f35d7101ffdeb4771d7c8ec517e&user_ids=ou_7abc4f35d7101ffdeb4771dabcde[用户相关的 ID 概念](/ssl:ttdoc/home/user-identity-introduction/introduction) */
+      /**
+       * user_id、open_id 或 union_id，默认为 open_id。
+       * 如果传入的值不是 open_id，需要一并传入 user_id_type 参数。
+       * 可一次查询多个 id 的用户，例如：user_ids=ou_8ebd4f35d7101ffdeb4771d7c8ec517e&user_ids=ou_7abc4f35d7101ffdeb4771dabcde
+       * [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction)
+       */
       user_ids?: string[]
     }
   }

package/src/types/helpdesk.ts

@@ -224,11 +224,11 @@ export namespace Helpdesk {
     export interface StartServiceRequest {
       /** 是否直接进入人工(若appointed_agents填写了，该值为必填) */
       human_service?: boolean
-      /** 客服 open ids (获取方式参考[获取单个用户信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service需要为true */
+      /** 客服 open ids (获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service需要为true */
       appointed_agents?: string[]
-      /** 用户 open id,(获取方式参考[获取单个用户信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) */
+      /** 用户 open id,(获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) */
       open_id: string
-      /** 工单来源自定义信息，长度限制1024字符，如设置，[获取工单详情](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get)会返回此信息 */
+      /** 工单来源自定义信息，长度限制1024字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get)会返回此信息 */
       customized_info?: string
     }
 
@@ -305,7 +305,10 @@ export namespace Helpdesk {
     export interface TicketImageQuery {
       /** 工单ID */
       ticket_id: string
-      /** 消息ID[查询消息ID](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/list) */
+      /**
+       * 消息ID
+       * [查询消息ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/list)
+       */
       msg_id: string
       /** index，当消息类型为post时，需指定图片index，index从0开始。当消息类型为img时，无需index */
       index?: number
@@ -347,7 +350,10 @@ export namespace Helpdesk {
       export interface CreateRequest {
         /** 消息类型；text：纯文本；post：富文本 */
         msg_type: string
-        /** - 纯文本，参考[发送文本消息](/ssl:ttdoc/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content；- 富文本，参考[发送富文本消息](/ssl:ttdoc/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content */
+        /**
+         * - 纯文本，参考[发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content；
+         * - 富文本，参考[发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content
+         */
         content: string
       }
 
@@ -606,7 +612,10 @@ export namespace Helpdesk {
     }
 
     export interface SearchQuery extends Pagination {
-      /** 搜索query，query内容如果不是英文，包含中文空格等有两种编码策略：1. url编码 2. base64编码，同时加上base64=true参数 */
+      /**
+       * 搜索query
+       * ，query内容如果不是英文，包含中文空格等有两种编码策略：1. url编码 2. base64编码，同时加上base64=true参数
+       */
       query: string
       /** 是否转换为base64,输入true表示是，不填写表示否，中文需要转换为base64 */
       base64?: string