Updated on 2026-04-16 GMT+08:00

Verifying a Sharing Access Code

Function

Verify a sharing access code. (This function is available only to whitelisted users.)

URI

POST /koodrive/ose/v1/share/public/verify

Request Parameters

Table 1 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

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

shortUrl

Yes

String

Definition:

Sharing short code.

Constraints:

N/A

Range:

N/A

Default Value:

N/A

extractCode

Yes

String

Definition:

Access code for sharing, which is specified when a sharing is created.

Constraints:

N/A

Range:

N/A

Default Value:

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

code

String

Response code.

msg

String

Response information.

kdstoken

String

Temporary token.

Example Requests

/koodrive/ose/v1/share/public/verify

{
  "shortUrl" : "1808628918203192832",
  "extractCode" : "31945314"
}

Example Responses

Status code: 200

OK

{
  "kdstoken" : "561bd7f1a8*********************301f11ee46f",
  "code" : 0,
  "msg" : "Success."
}

Status Codes

Status Code

Description

200

OK