Help Center/ KooDrive/ API Reference（Carrier）/ API/ Sharing Management - Accessing Links - Public/ Obtaining Sharing Information
Updated on 2026-04-16 GMT+08:00
View PDF
Share

Obtaining Sharing Information

Function

Obtain the shared link information. (This function is available only to whitelisted users.)

URI

GET /koodrive/ose/v1/share/public/userInfo

Table 1 Query Parameters

Parameter

Mandatory

Type

Description

shortUrl

Yes

String

Definition:

Sharing short code.

Constraints:

N/A

Range:

N/A

Default Value:

N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Traceid

No

String

Definition:

Service trace ID, which contains 58 bits.

Constraints:

N/A

Range:

The value contains 58 bits.

Default Value:

N/A

language

No

String

Definition:

Language code.

Constraints:

The value must comply with the internationalization specifications. For example, en_us indicates English (United States).

Range:

N/A

Default Value:

en-US

X-Hw-Agentname

Yes

String

Definition:

Carrier name.

Constraints:

N/A

Range:

N/A

Default Value:

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

code

Integer

Response code.

msg

String

Response information.

link

CommonShareLink object

Public information of the access link.
Table 4 CommonShareLink

Parameter

Type

Description

shareId

String

Sharing ID.

shortUrl

String

Sharing short code.

shareTime

String

Time when the file is shared.

ownerId

String

Sharer ID.

ownerName

String

Sharer name.

expireTime

String

Expiration time.

status

Integer

Sharing status. 0: determined based on the expiration time. 1: The file has been deleted. 2: invalid. 3: expired.

expireDate

String

Validity period.

Example Requests

/koodrive/ose/v1/share/public/userInfo?shortUrl=15929**********41825

Example Responses

Status code: 200

OK

{
  "link" : {
    "shareId" : "1592**********1824",
    "shortUrl" : "1592**********825",
    "shareTime" : "2025-01-06T11:42:37.037Z",
    "ownerId" : "1592**********54689",
    "ownerName" : "",
    "expireTime" : "2025-01-18T11:58:00.000Z",
    "expireDate" : "11",
    "status" : 0
  },
  "code" : 0,
  "msg" : "Successful."
}

Status Codes

Status Code

Description

200

OK