List my share links

GET

/share

Auth: JWT Required

Request

Authorization

Add the parameter

Authorization

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

Example:

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

Query Params

page_size

integer

required

Page size.

>= 10<= 100

Example:

order_by

enum<string>

optional

Field name for ordering.

Allowed values:

viewsdownloadspriceremain_downloadsid

order_direction

enum<string>

optional

Allowed values:

ascdesc

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)

optional

array[object (Share) {16}]

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": "g2guA",
                "name": "Inspirations",
                "visited": 0,
                "price": 20,
                "expires": "2025-06-17T16:16:39+08:00",
                "unlocked": true,
                "source_type": 1,
                "owner": {
                    "id": "bnUn",
                    "email": "luke@skywalker.com",
                    "nickname": "Luke Skywalker",
                    "avatar": "file",
                    "created_at": "2023-08-06T19:21:59+08:00"
                },
                "created_at": "2025-06-10T16:16:39+08:00",
                "expired": false,
                "url": "http://localhost:5173/s/g2guA/gcqzfaze",
                "permission_setting": {
                    "same_group": null,
                    "everyone": "AQ==",
                    "other": null,
                    "anonymous": "BQ==",
                    "group_explicit": {},
                    "user_explicit": {}
                },
                "is_private": true,
                "password": "gcqzfaze",
                "share_view": true
            },
            {
                "id": "8X9FD",
                "name": "新文件2.txt",
                "visited": 17,
                "downloaded": 2,
                "unlocked": true,
                "source_type": 0,
                "owner": {
                    "id": "bnUn",
                    "email": "luke@skywalker.com",
                    "nickname": "Luke Skywalker",
                    "avatar": "file",
                    "created_at": "2023-08-06T19:21:59+08:00"
                },
                "created_at": "2025-06-05T10:27:18+08:00",
                "expired": false,
                "url": "http://localhost:5173/s/8X9FD",
                "permission_setting": {
                    "same_group": null,
                    "everyone": "AQ==",
                    "other": null,
                    "anonymous": "AQ==",
                    "group_explicit": {},
                    "user_explicit": {}
                }
            }
        ],
        "pagination": {
            "page": 0,
            "page_size": 50,
            "is_cursor": true
        }
    },
    "msg": ""
}

Modified at 2025-06-27 03:17:48

Get share link info

Delete share link