创建文档版本

POST

https://open.feishu.cn/open-apis/drive/v1/files/{file_token}/versions

创建文档版本。

错误码

HTTP状态码	错误码	描述	排查建议
400	1068400	Has no permission, please apply the file permission of reading or edition.	无阅读/编辑权限，请申请源文档的阅读/编辑权限。
400	1068401	Review no pass, the title has illegal content.	标题审核不通过，含非法内容，请重新命名。
404	1068404	Parent file does not exist, please check the file status.	源文档不存在，请检查文档是否已删除。
400	1068410	Params error, param [file_token] is wrong.	`file_token`请求参数错误，请检查参数。
400	1068411	Params error, param [obj_type] is wrong.	`obj_type`请求参数错误，请检查参数。
400	1068425	Request failed, please contact the engineer-https://applink.feishu.cn/TLJsX982.	请求失败，请联系业务方oncall。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/drive/v1/files/doxbcyvqZlSc9WlHvQMlSJwUrsb/versions' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "文档标题",
    "version": "version1",
    "parent_token": "1665739388",
    "owner_id": "694699009591869450",
    "creator_id": "694699009591869451",
    "create_time": "1660708537",
    "update_time": "1660708537",
    "status": "0",
    "obj_type": "docx",
    "parent_type": "docx"
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "name": "文档标题",
    "version": "version1",
    "parent_token": "1665739388",
    "owner_id": "694699009591869450",
    "creator_id": "694699009591869451",
    "create_time": "1660708537",
    "update_time": "1660708537",
    "status": "0",
    "obj_type": "docx",
    "parent_type": "docx"
  }
}

请求参数

Path 参数

file_token

string

源文档token

必需

示例值:

doxbcyvqZlSc9WlHvQMlSJwUrsb

Query 参数

user_id_type

string

可选

用户 ID 类型示例值："open_id" 可选值有： open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？默认值：open_id 当值为 user_id，字段权限要求：获取用户 user ID

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

name

string

可选

版本文档标题示例值："文档标题"

version

string

可选

版本文档版本号示例值："version1"

parent_token

string

可选

shtbcpM2mm3znrLfWnf4browTYp 示例值："1665739388"

owner_id

string

可选

版本文档所有者id 示例值："694699009591869450"

creator_id

string

可选

版本文档创建者id 示例值："694699009591869451"

create_time

string

可选

版本文档创建时间示例值："1660708537"

update_time

string

可选

版本文档更新时间示例值："1660708537"

status

string

可选

版本文档状态示例值："0" 可选值有： 0：正常状态 1：删除状态 2：回收站状态

obj_type

string

可选

版本文档类型示例值："docx" 可选值有： doc：doc文档 sheet：sheet文档 bitable：bitable文档 docx：docx文档

parent_type

string

可选

源文档类型示例值："docx" 可选值有： doc：doc文档 sheet：sheet文档 bitable：bitable文档 docx：docx文档

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

name

string

版本文档标题

必需

version

string

版本文档版本号

必需

parent_token

string

必需

shtbcpM2mm3znrLfWnf4browTYp

owner_id

string

版本文档所有者id

必需

creator_id

string

版本文档创建者id

必需

create_time

string

版本文档创建时间

必需

update_time

string

版本文档更新时间

必需

status

string

必需

版本文档状态可选值有： 0：正常状态 1：删除状态 2：回收站状态

obj_type

string

必需

版本文档类型可选值有： doc：doc文档 sheet：sheet文档 bitable：bitable文档 docx：docx文档

parent_type

string

必需

源文档类型可选值有： doc：doc文档 sheet：sheet文档 bitable：bitable文档 docx：docx文档

修改于 2023-01-13 06:35:59

概述

删除文档版本

创建文档版本

错误码#

请求参数

返回响应

错误码