UpdateShareLink - 修改分享

修改分享。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/share_link/update HTTP/1.1

请求参数

名称类型必填描述示例值
bodyobject

请求体。

share_idstring

分享 id

7JQX1FswpQ8
share_pwdstring

提取码。 提取码长度范围[0, 64]。 长度 0 表示提取码是""

abcF123x
expirationstring

失效时间点。 RFC3339 格式,比如:"2020-06-28T11:33:00.000+08:00"。 ""表示永久有效

2020-06-28T11:33:00.000+08:00
descriptionstring

描述。 长度范围[0, 1024]

百家讲坛全集
share_namestring

分享名。 默认使用第一个文件名。 长度范围[0, 128]

百家讲坛-1.mp4
statusstring

分享状态。 枚举值如下:

  • disabled(已取消)
  • enabled(有效)
enabled
preview_countlong

预览次数。 次数要求>=0

3
save_countlong

转存次数。 次数要求>=0

5
download_countlong

下载次数。 次数要求>=0

30
report_countlong

举报次数。 次数要求>=0

1
video_preview_countlong

视频预览次数。 次数要求>=0

100
disable_previewboolean

禁止预览

false
disable_saveboolean

禁止转存

false
disable_downloadboolean

禁止下载

false
preview_limitlong

分享预览次数限制。 次数要求>=0。 次数 0 表示不限制

100
save_limitlong

分享转存次数限制。 次数要求>=0。 次数 0 表示不限制

100
download_limitlong

分享下载次数限制。 次数要求>=0。 次数 0 表示不限制

100
office_editableboolean

允许在线编辑分享的文档

true

返回参数

名称类型描述示例值
ShareLink

返回信息

示例

正常返回示例

JSON格式

{
  "share_id": "7JQX1FswpQ8",
  "share_pwd": "abcF123x",
  "drive_id": "1",
  "file_id_list": [
    "[\"xx\"]"
  ],
  "expiration": "2020-06-28T11:33:00.000+08:00",
  "expired": false,
  "created_at": "2019-08-20T06:51:27.292Z",
  "updated_at": "2019-08-20T06:51:27.292Z",
  "description": "videos",
  "share_name": "video-1.MP4",
  "creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
  "status": "enabled",
  "preview_count": 10,
  "save_count": 2,
  "download_count": 5,
  "report_count": 0,
  "video_preview_count": 1,
  "access_count": 4,
  "disable_preview": false,
  "disable_save": false,
  "disable_download": false,
  "preview_limit": 100,
  "save_limit": 100,
  "download_limit": 100,
  "require_login": false,
  "share_all_files": true,
  "share_msg": "pwd: 123",
  "save_download_limit": 100,
  "office_editable": true
}

错误码

访问错误中心查看更多错误码。