文件分块上传分块上传初始化

POST

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

步骤如下：

上传初始化：计算文件的分块（分块大小固定为2M，即2097152字节）的累积sha值（使用sha1算法），提交到企业微信开放平台。如果命中秒传，后续步骤则不需要再进行。

分块上传文件：分别上传分块文件（可并发上传，并发数建议不超过10）

标记上传完成：如果文件上传完整，返回上传成功的fileid

权限说明

企业需要使用“微盘”secret所获取的accesstoken来调用（accesstoken如何获取？）

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）

第三方应用需具有“微盘”权限

代开发自建应用需具有“微盘”权限

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

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "spaceid": "SPACEID",
    "fatherid": "FATHERID",
    "selected_ticket": "SELECTED_TICKET",
    "file_name": "FILE_NAME",
    "size": 123,
    "block_sha": [
        "STATE1",
        "STATE2"
    ],
    "skip_push_card": false
}'

响应示例

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

请求参数

Body 参数application/json

spaceid

string

空间spaceid

可选

fatherid

string

可选

当前目录的fileid，根目录时为空间spaceid

selected_ticket

string

可选

微盘和文件选择器jsapi返回的selectedTicket。若填此参数，则不需要填spaceid/fatherid。

file_name

string

文件名字

必需

size

integer

必需

文件大小。最大支持20G

block_sha

array[string]

必需

文件分块累积sha值，按分块顺序填入数组。参考附录-分块累积sha说明

skip_push_card

boolean

可选

文件创建完成时是否推送企业微信卡片。默认false，即默认推送卡片

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码说明

必需

hit_exist

boolean

是否命中秒传

必需

upload_key

string

必需

文件上传凭证。不命中秒传时返回，作为file_upload_part参数

fileid

string

必需

文件fileid。命中秒传时返回，此时上传流程完成

文件管理上传文件

文件分块上传分块上传文件

文件分块上传 分块上传初始化

请求参数

返回响应

文件分块上传分块上传初始化