创建导入任务

• 该接口用于创建导入文件的任务，并返回导入任务 ID。导入文件指将本地文件如 Word、TXT、Markdown、Excel 等格式的文件导入为某种格式的直书在线云文档。该接口为异步接口，需要继续调用查询导入任务结果接口获取导入结果。了解完整的导入文件步骤，参考导入文件概述。

文件类型	对应的直书类型
docx	直书文档
md	直书文档
txt	直书文档
xlsx	直书表格
csv	直书表格

请求

基本
HTTP URL	https://hi-gw.weizhipin.com/open-apis/zhishu/resource/import
HTTP Method	POST
支持的应用 类型	自建应用
权限要求 开启任一权限即可	直书资源上传、导入

请求头

名称	类型	必填	描述
Authorization	string	是	user_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"
Content-Type	string	是	固定值："multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

请求体

名称	类型	必填	描述
name	string	是	要上传的文件的名称。 示例值："直书.pdf" 数据校验规则： 最大长度：250 字符
folderVisitCode	string	是	指定上传文件所属的文件夹目录的 visitCode；参数为空字符串时，表示在用户我的文档根目录下创建文件
size	long	是	文件大小，单位：字节
fileMd5	string	是	文件内容md5值，用于校验文件是否重复上传
file	file	是	文件的二进制内容

cURL示例

curl --location --request POST 'https://hi-gw.weizhipin.com/open-apis/zhishu/resource/upload' \
--header 'Authorization: Bearer t-7f1bcd13fc57d46bac21793a18e560' \
--header 'Content-Type: multipart/form-data' \
--form 'name="demo.pdf"' \
--form 'folderVisitCode="pI3q3Lcgay5"' \
--form 'fileMd5="f9e1c0399e42aeec213710b5f65f296c"' \
--form 'size="1024"' \
--form 'file=@"/path/demo.pdf"'

请求体示例

---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="name";

demo.pdf
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="folderVisitCode";

pI3q3Lcgay5
---7MA4YWxkTrZu0gW

Content-Disposition: form-data; name="size";

1024
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="fileMd5";

f9e1c0399e42aeec213710b5f65f296c
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file";
Content-Type: application/octet-stream

file binary
---7MA4YWxkTrZu0gW

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
message	string	错误描述
zpData	string	导入任务的id

响应体示例

{
 "code": 0,
 "message": "success",
 "data": "importTaskId"

}