使用DocuSign Folder API无法获取自定义文件夹test1_folder的问题咨询

问题分析 #

你调用{{baseUrl}}/v2.1/accounts/{{accountId}}/folders?sub_folder_depth=-1只返回系统默认文件夹（Inbox、Sent、Drafts、Deleted），是因为该接口默认仅返回系统文件夹，不会包含用户创建的自定义文件夹。

解决方案 #

1. 添加参数获取所有类型文件夹 #

直接在请求URL中添加include_folders=all参数，让接口返回系统文件夹和自定义文件夹：

{{baseUrl}}/v2.1/accounts/{{accountId}}/folders?sub_folder_depth=-1&include_folders=all

这个参数会让接口返回所有层级的系统+自定义文件夹，你应该能在响应中找到test1_folder。

2. 单独获取自定义根文件夹的子项（如果方法1无效） #

如果你的test1_folder是在界面中“Folders”根容器下创建的，可以先获取这个根容器的ID：

• 调用基础接口{{baseUrl}}/v2.1/accounts/{{accountId}}/folders，在响应中找到name为“Folders”、type为custom的文件夹，记录它的folderId
• 然后调用该文件夹的子目录接口：

{{baseUrl}}/v2.1/accounts/{{accountId}}/folders/{{customRootFolderId}}?sub_folder_depth=-1

这样就能拿到该根文件夹下所有自定义子文件夹，包括test1_folder。

3. 权限检查 #

确保你使用的API账号（集成密钥关联的用户）在DocuSign界面中能正常看到test1_folder，如果账号没有访问权限，API也无法返回该文件夹。

内容的提问来源于stack exchange，提问作者Ethiraj Krishna