使用Box Sign API创建签署请求时持续出现404 Not Found错误求助

API端点信息 #

• URL：https://api.box.com/2.0/sign_requests
• HTTP方法：POST
• 访问令牌：Full-authorization

发送的请求体 #

{
    "signers": [
        {
            "role": "signer",
            "email": "y.alali@sened.ngo"
        }
    ],
    "source_files": [
        {
            "type": "file",
            "id": "1611107706949"
        }
    ],
    "parent_folder": {
        "type": "folder",
        "id": "278098710623"
    },
    "is_document_preparation_needed": true
}

收到的响应 #

{
    "type": "error",
    "code": "not_found",
    "status": 404,
    "message": "Not found",
    "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
    "request_id": "0e33bee75ee29cf32c3c2aefc0b0b7adb",
    "context_info": {
        "errors": [
            {
                "name": "Not Found",
                "message": "Not Found",
                "reason": "not_found"
            }
        ]
    }
}

已采取的排查步骤 #

• 验证了文件及父文件夹的存在性与可访问性
• 确认访问令牌具备必要的权限与作用域
• 确保访问令牌关联的用户拥有文件和文件夹的协作者访问权限

补充信息 #

• 文件ID 1611107706949存在且可访问
• 父文件夹ID 278098710623存在且可访问
• 访问令牌已获得完整授权，具备必要作用域
• 访问令牌关联的用户拥有所需权限

问题 #

能否帮助识别使用Box Sign API成功创建签署请求所需的其他要求或配置？

可能的排查方向 #

1. 检查Box Sign功能是否启用
   确认你的Box账户已开通Box Sign服务，部分基础账户默认未启用该功能，需要通过管理员控制台开启。

2. 验证文件类型兼容性
   Box Sign仅支持特定格式文件（如PDF、DOCX等），检查目标文件1611107706949的格式是否在支持列表内，非支持格式会导致请求失败。

3. 确认父文件夹的写入权限
   除基础访问权限外，需确保用户对父文件夹拥有上传/创建内容的权限，签署请求生成的文件需要写入该文件夹。

4. 核对访问令牌的实际作用域
   即便标注为Full-authorization，建议通过Box令牌调试工具确认令牌包含sign_requests:write、files:read等必要作用域，避免权限未正确授予。

5. 检查源文件状态
   若源文件被其他用户锁定、处于待处理状态，API将无法正常访问，需确认文件的锁定状态。

6. 临时调整is_document_preparation_needed参数
   将该参数设为false发起测试请求，排除文档准备流程中的异常。

内容的提问来源于stack exchange，提问作者Yaman Al-ali