多可文档平台API
文件夹及文件接口---上传文件
上传文件到指定文件夹,API上传文件需要2步实现此功能。
第一步:得到上传文件地址
请求方式: POST(HTTP/HTTPS)
请求地址: /api/ff/file/uploadUrl?token=ACCESS_TOKEN
请求包示例:
{
"fid": "F00003",
"modTime": "2020-05-01 12:00:00"
}
参数说明:
参数 | 类型 | 必须 | 说明 |
token |
string |
是 |
调用接口凭证 |
fid |
string |
是 |
目标父文件夹ID |
modTime |
string |
是 |
文件修改时间,如果为空,修改时间为上传时间 |
返回结果示例::
{
"errcode": 0,
"errmsg": "",
"url": "/api/fileUpload?fid=F00003&timeHash=f7e945551216&fileSHA=*&modTime=1588305600&token=805ddf8960123330799654321098"
}
返回参数说明::
参数 | 类型 | 说明 |
errcode |
int32 |
出错返回码,为0表示成功,非0表示调用失败 |
errmsg |
string |
返回码提示语 |
url |
string |
文件上传地址,此地址10分钟有效,过期请重新得到地址 |
权限要求:需要目标文件夹的【文件上传/修改】权限。
第二步:用得到的上传地址,使用multipart/form-data编码方式提交数据到服务器。
以下是一个HTML页面上传文件示例,其他语言使用HTTP组件实现文件上传。
返回结果示例:
{
"errcode":0,
"errmsg":"",
"fileId":"X00028"
}
返回参数说明:
参数 | 类型 | 说明 |
errcode |
int32 |
出错返回码,为0表示成功,非0表示调用失败 |
errmsg |
string |
返回码提示语 |
fileId |
string |
新文件的ID |