# 创建直书文档
- 在直书系统里创建文件,支持创建直书文档、表格。只能在自己有编辑以上的权限的目录下新建文件。
# 请求
基本 | |
---|---|
HTTP URL | https://hi-gw.weizhipin.com/open-apis/zhishu/resource/file/create |
HTTP Method | POST |
支持的应用类型 | 自建应用 |
权限要求 开启任一权限即可 | 资源创建 |
# 请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Authorization | string | 是 | user_access_token 值格式:"Bearer access_token "示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" |
Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
# 请求体
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
name | string | 是 | 创建的文件的标题,不传默认名称为”无标题“,超过120长度则截断 |
folderVisitCode | list | 是 | 指定新建文件所属的文件夹目录的 visitcode;参数为空字符串时,表示在用户我的文档根目录下创建文件 |
type | string | 是 | 需要创建的文件的类型,可选值: zpDoc:直书文档 zpXls:直书表格 |
# 请求体示例
{
"name":"测试表格",
"type":"zpXls",
"folderVisitCode":"fdsjfdsj"
}
1
2
3
4
5
2
3
4
5
# 响应
# 响应体
名称 | 类型 | 描述 |
---|---|---|
code | int | 错误码,非 0 表示失败 |
message | string | 错误描述 |
zpData | object | |
-- url | string | 文件的访问地址 |
-- visitCode | string | 文件的visitCode |
# 响应体示例
{
"code":0,
"message":"Success",
"zpData":{
"url":"https://zhishu.zhipin.com/wiki/JdRBCrTRXsS",
"visitCode":"JdRBCrTRXsS"
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
← 获取文件夹中的文件清单 获取文件元数据 →