为了支持大文件上传，将文件进行分块，然后分别上传。

步骤如下：

• 上传初始化：计算文件的分块（分块大小固定为2M，即2097152字节）的累积sha值（使用sha1算法），提交到企业微信开放平台。如果命中秒传，后续步骤则不需要再进行。
• 分块上传文件：分别上传分块文件（可并发上传，并发数建议不超过10）
• 标记上传完成：如果文件上传完整，返回上传成功的fileid

权限说明

• 企业需要使用“微盘”secret所获取的accesstoken来调用（accesstoken如何获取？）
• 自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）
• 第三方应用需具有“微盘”权限
• 代开发自建应用需具有“微盘”权限

分块上传初始化

请求分块上传初始化接口，如果命中秒传，则流程结束，完成上传。

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_upload_init?access_token=ACCESS_TOKEN

请求包体

{
    "spaceid": "SPACEID",
    "fatherid": "FATHERID",
    "selected_ticket": "SELECTED_TICKET",
    "file_name": "FILE_NAME",
    "size": 123,
    "block_sha": [
        "STATE1",
        "STATE2"
    ],
    "skip_push_card": false
}

参数说明

注意：spaceid/fatherid和selected_ticket必须填且仅填其中一组参数。

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "hit_exist": false,
    "upload_key": "UPLOAD_KEY",
    "fileid": "FILEID"
}

参数说明

分块上传文件

将文件内容按2M分块，依次请求分块上传文件接口。

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_upload_part?access_token=ACCESS_TOKEN

请求包体

{
    "upload_key": "UPLOAD_KEY",
    "index": 1,
    "file_base64_content": "FILE_BASE64_CONTENT"
}

参数说明

返回示例

{
    "errcode": 0,
    "errmsg": "ok"
}

参数说明

分块上传完成

请求分块上传完成接口，流程结束，完成上传。

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_upload_finish?access_token=ACCESS_TOKEN

请求包体

{
    "upload_key": "UPLOAD_KEY"
}

参数说明

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "fileid": "FILEID"
}

参数说明

附录-分块累积sha说明

分块的累积sha值计算过程如下：

• 将要上传的文件内容，按2M分块；
• 对每一个分块，依次sha1_update；
• 每次update，记录当前的state，转成16进制，作为当前块的累积sha值；
• 当为最后一块（可能小于2M），update完再sha1_final得到的sha1值（即整个文件的sha1），作为最后一块的累积sha值。

以上过程得到的sha值，保持顺序依次放到数组，作为file_upload_init接口的block_sha参数输入。

相关示例代码见：c++版本。其他语言可根据以上流程自行实现，跟提供的c++版本实际测试结果对比验证。

提供了demo文件和其对应的接口调用关键参数的说明文档，可用来验证开发者逻辑实现的正确性。