搜索分享。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/share_link/search HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体参数。 |
|
| limit |
integer |
否 |
限定此次返回资源的数量，取值范围[1,100]。如果没有填写，默认取值 100。 返回结果可以小于指定的数量，但不能多于指定的数量。 |
50 |
| marker |
string |
否 |
设定结果从 marker 之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。
|
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| return_total_count |
boolean |
否 |
是否返回搜到到的总记录数 |
false |
| order_by |
string |
否 |
排序字段。 默认按照创建时间倒序排列。 枚举值如下：
枚举值：
|
created_at |
| order_direction |
string |
否 |
排序方式。 如果是排序字段是 created_at 或者 updated_at，则默认是倒序，其他排序字段默认是升序。 枚举值如下：
枚举值：
|
ASC |
| creators |
array |
否 |
分享创建者（user_id） 1）如果不指定, 那么会根据用户本身的权限进行查询 1.1 网盘管理员/超管：所有成员 1.2 团队管理员：团队成员 1.3 普通用户：自身 2）如果指定, 那么只能指定那些有权限的成员, 参考 1） |
|
|
string |
否 |
分享创建者 |
c9b7a5aa04d14ae3867fdc886fa01da4 |
|
| query |
string |
否 |
查询条件 1）支持字段： 1.1 created_at 创建时间 1.2 updated_at 更新时间 1.3 share_name_for_fuzzy 分享名, 支持模糊匹配（match） 1.4 status 分享状态, 枚举值 enabled（分享中）/disabled（已取消） 1.5 expired_time 超时时间 永不过期：expired_time='1970-01-01T00:00:00', 返回的 expiration="" expired_time<'1970-01-02T00:00:00'系统保留使用,不表示具体时间 |
created_at>='2022-01-18T02:50:00' and created_at<'2022-01-19T09:45:28' and share_name_for_fuzzy match 'HD.mp4' and status in ['enabled', 'disabled'] and expired_time='1970-01-01T00:00:00' |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| items |
array |
分享列表 |
|
| ShareLink |
分享 |
||
| next_marker |
string |
下次起始点 |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| total_count |
integer |
总数量 |
101 |
示例
正常返回示例
JSON格式
{
"items": [
{
"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
}
],
"next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
"total_count": 101
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。