多可文档平台API
文件夹及文件接口---创建文件夹
新建一个文件夹,文件夹名称不能和父文件夹其他子文件夹重名,名称不能超过238字符,描述不能超过2048字符。
请求方式: POST(HTTP/HTTPS)
请求地址: /api/ff/folder/add?fid=ID&token=ACCESS_TOKEN
请求包示例:
{
"name": "测试文件夹",
"desc": "文件夹描述",
"order": 10000
}
参数说明:
参数 | 类型 | 必须 | 说明 |
token |
string |
是 |
调用接口凭证 |
fid |
string |
否 |
父文件夹id,如果为空,直接增加到根节点 |
name |
string |
是 |
文件夹名称,238字符以内,且文件夹名称中不能包括以下字符: \ / : * ? " < > | |
desc |
string |
否 |
文件夹描述,2048字符以内 |
order |
int32 |
是 |
在父文件夹中的排序值,值越小排序越靠前 |
返回结果示例:
{
"errcode": 0,
"errmsg": "",
"id": "F00553",
"name": "测试文件夹",
"fatherName": ""
}
返回参数说明:
参数 | 类型 | 说明 |
errcode |
int32 |
出错返回码,为0表示成功,非0表示调用失败 |
errmsg |
string |
返回码提示语 |
id |
string |
新建的文件夹ID |
name |
string |
无效字段 |
fatherName |
string |
无效字段 |
权限要求:需要目标文件夹的【文件夹新建/修改】权限。