List user's share links

GET

/user/shares/{user-id}

List public share links created by the given user.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Path Params

user-id

string

required

ID of the user.

Example:

lpua

Query Params

page_size

integer

required

Page size.

>= 10<= 100

Example:

order_by

enum<string>

optional

Field name for ordering.

Allowed values:

viewsdownloadspriceremain_downloadsid

Default:

order_direction

enum<string>

optional

Allowed values:

ascdesc

Default:

asc

Example:

asc

next_page_token

string

optional

Token for requesting next page. Empty value means requesting the first page.

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

data

object (ListShareResponse)

required

array[object (Share) {17}]

required

List of share links.

pagination

object

required

Pagination propertities.

code

integer

required

Response code.
0 - Success.

Default:

Example:

msg

string

optional

Human readable error message (if any).

error

string | null

optional

Internal error message, only visable in debug mode.

correlation_id

string <uuid> | null

optional

Correlation ID of the request. Only presented on failed reqeust.

Example:

b4351ecc-ee1a-4455-bc94-2c3dbcc58538

Example

{
    "code": 0,
    "data": {
        "shares": [
            {
                "id": "VoMFL",
                "name": "BrNJdjbgi1mvqBf7zycSCskw6ky8nle0",
                "visited": 1,
                "unlocked": true,
                "source_type": 1,
                "owner": {
                    "id": "lpua",
                    "email": "admin@cloudreve.org",
                    "nickname": "Aaron Liu2",
                    "avatar": "file",
                    "created_at": "2023-08-06T19:21:59+08:00"
                },
                "created_at": "2025-04-27T16:12:13+08:00",
                "expired": false,
                "url": "http://localhost:5173/s/VoMFL/2rje2bdj",
                "permission_setting": {
                    "same_group": null,
                    "everyone": "AQ==",
                    "other": null,
                    "anonymous": "AQ==",
                    "group_explicit": {},
                    "user_explicit": {}
                },
                "is_private": true,
                "password": "2rje2bdj"
            },
            {
                "id": "KDVIn",
                "name": "使用协议.txt",
                "visited": 6,
                "downloaded": 2,
                "price": 1000,
                "unlocked": true,
                "source_type": 0,
                "owner": {
                    "id": "lpua",
                    "email": "admin@cloudreve.org",
                    "nickname": "Aaron Liu2",
                    "avatar": "file",
                    "created_at": "2023-08-06T19:21:59+08:00"
                },
                "created_at": "2025-04-22T17:12:52+08:00",
                "expired": false,
                "url": "http://localhost:5173/s/KDVIn",
                "permission_setting": {
                    "same_group": null,
                    "everyone": "AQ==",
                    "other": null,
                    "anonymous": "AQ==",
                    "group_explicit": {},
                    "user_explicit": {}
                }
            }
        ],
        "pagination": {
            "page": 0,
            "page_size": 50,
            "is_cursor": true,
            "next_token": "eyJpZCI6Im1LTmxTRCJ9"
        }
    },
    "msg": ""
}

Modified at 2025-06-27 03:10:47

Get user

Get storage capacity