森络云盘API文档(森络盘)
  1. File
森络云盘API文档(森络盘)
  • Site
    • Ping
      GET
    • Get CAPTCHA
      GET
    • Get site settings
      GET
    • Report abuse
      POST
  • Session
    • Token
      • Password sign-in
      • Finish sign-in with 2FA
      • Refresh Token
      • Sign out
    • OpenID
      • Prepare OpenID sign-in
      • Finish OpenID sign-in
      • Unlink OpenID
    • Passkey
      • Prepare Passkey sign-in
      • Finish Passkey sign-in
    • Prepare login
      GET
  • User
    • Passkey
      • Prepare passkey registration
      • Finish passkey registration
      • Delete passkey
    • Setting
      • List available storage policies
      • List available nodes
      • Get preferences
      • Prepare enabling 2FA
      • Update preference setting
      • Update profile pricture
    • Sign up
    • Send reset password email
    • Reset password via temp link
    • Get profile picture
    • Get user
    • List user's share links
    • Get storage capacity
    • Search user
    • List credit changes
    • List payments
  • Callback
    • Complete OBS upload
    • Complete OneDrive upload
    • Complete COS upload
    • Complete S3 upload
  • Workflow
    • Remote Download
      • Create remote download
      • Select files to download
      • Cancel task
    • List tasks
    • Get task progress
    • Create archive
    • Extract archive
    • Relocate storage policy
    • Import external files
  • File
    • Permission
      • Set permission
      • Delete permission setting
    • Upload
      • Create upload session
      • Upload file chunk
      • Delete upload session
    • Pin
      • Pin to sidebar
      • Delete a pin
    • Version
      • Set file version
      • Delete file version
    • Direct Link
      • Create direct links
      • Delete direct link
    • List files
      GET
    • List file activities
      GET
    • Get file info
      GET
    • Get thumbnail URL
      GET
    • Get archive file list
      GET
    • Update file content
      PUT
    • Create viewer session
      PUT
    • Create file
      POST
    • Rename file
      POST
    • Move or copy files
      POST
    • Create download URL
      POST
    • Restore from trash bin
      POST
    • Delete file
      DELETE
    • Force unlock
      DELETE
    • Patch metadata
      PATCH
    • Mount storage policy
      PATCH
    • Update view setting
      PATCH
  • Share
    • Create share link
    • Edit share link
    • Get share link info
    • List my share links
    • Delete share link
  • VAS
    • Payment
      • Create a payment
      • Get payment status
    • GiftCode
      • Check gift code
      • Redeem gift code
  • Group
    • List groups
  • WebDAV
    • List accounts
    • Create account
    • Update account
    • Delete account
  • 数据模型
    • Response
    • SiteConfig
    • User
    • Group
    • FileViewer
    • PaymentProvider
    • PaymentSetting
    • StorageProduct
    • GroupSKU
    • CaptchaFields
    • Token
    • LoginResponse
    • PermissionSetting
    • Share
    • PaginationResults
    • ListShareResponse
    • TaskListResponse
    • Node
    • TaskResponse
    • Progress
    • ArchiveWorkflowService
    • StoragePolicy
    • Entity
    • ExtendedInfo
    • FolderSummary
    • FileResponse
    • NavigatorProps
    • ListResponse
    • LogEntry
    • Activity
    • FileActivitiesResponse
    • ExplorerView
    • ListViewColumn
    • PinFileService
    • ShareCreateService
    • Payment
    • Passkey
    • DavAccount
    • CreateDavAccountService
    • CustomProps
    • CustomNavItem
    • CustomHTML
    • ArchivedFile
  1. File

List files

GET
/file
List files under given URI, can also be used to search files if the URI contains search conditions.

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/file?uri=cloudreve://my/Luke'\''s%20AMA&page=0&page_size=50' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200Success
application/json
Body

示例
{
    "code": 0,
    "data": {
        "files": [
            {
                "type": 1,
                "id": "N93dL8ig",
                "name": "Takeout",
                "permission": null,
                "created_at": "2025-02-13T20:14:15+08:00",
                "updated_at": "2025-02-13T20:17:36+08:00",
                "size": 0,
                "metadata": {},
                "path": "cloudreve://my/Luke's%20AMA/Takeout",
                "capability": "39/9",
                "owned": true,
                "primary_entity": "zOie"
            },
            {
                "type": 1,
                "id": "8zXA03uL",
                "name": "新建文件夹",
                "permission": null,
                "created_at": "2025-02-20T15:16:28+08:00",
                "updated_at": "2025-02-20T15:16:28+08:00",
                "size": 0,
                "metadata": {
                    "tag:asd": ""
                },
                "path": "cloudreve://my/Luke's%20AMA/%E6%96%B0%E5%BB%BA%E6%96%87%E4%BB%B6%E5%A4%B9",
                "capability": "39/9",
                "owned": true,
                "primary_entity": "zOie"
            },
            {
                "type": 0,
                "id": "8zXBp3UL",
                "name": "sample.psd",
                "permission": null,
                "created_at": "2025-05-22T14:34:24+08:00",
                "updated_at": "2025-05-22T14:34:24+08:00",
                "size": 3285099,
                "metadata": {
                    "thumb:disabled": ""
                },
                "path": "cloudreve://my/Luke's%20AMA/%E5%B0%8F%E7%88%B1%E8%B1%86.psd",
                "capability": "39/9",
                "owned": true,
                "primary_entity": "jYOAc8"
            }
        ],
        "parent": {
            "type": 1,
            "id": "0OmpAGUn",
            "name": "Luke's AMA",
            "permission": null,
            "created_at": "2024-01-27T10:58:20+08:00",
            "updated_at": "2025-05-23T15:09:15+08:00",
            "size": 0,
            "metadata": null,
            "path": "cloudreve://my/Luke's%20AMA",
            "capability": "39/9",
            "owned": true,
            "primary_entity": "zOie"
        },
        "pagination": {
            "page": 0,
            "page_size": 100,
            "is_cursor": true
        },
        "props": {
            "capability": "39/9",
            "max_page_size": 2000,
            "order_by_options": [
                "name",
                "size",
                "updated_at",
                "created_at"
            ],
            "order_direction_options": [
                "asc",
                "desc"
            ]
        },
        "context_hint": "5c6ea8a1-86e0-4967-8d40-598c6eb78bff",
        "mixed_type": false,
        "storage_policy": {
            "id": "Emta",
            "name": "minio",
            "type": "s3",
            "max_size": 0
        }
    },
    "msg": ""
}
修改于 2025-12-07 14:35:40
上一页
Delete direct link
下一页
List file activities
Built with