搜索分享。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求语法
POST /v2/share_link/search HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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' |
返回参数
示例
正常返回示例
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": "",
"save_download_limit": 0
}
],
"next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
"total_count": 101
}错误码
访问错误中心查看更多错误码。