Public download gateway for an opaque share ID.

GET

/{opaque-id}

const url = 'https://s.share2.us/example';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://s.share2.us/example

Parameters

Path Parameters

opaque-id

required

string

>= 12 characters

Responses

200

Share landing metadata or HTML page.

object

public_id

required

string

>= 12 characters

filename

required

string

size_bytes

required

integer format: int64

state

required

string

Allowed values: created uploading uploaded scanning ready expired revoked blocked deleted

password_required

boolean

download_url

string | null format: uri

expires_at

required

string format: date-time

Example

{
  "state": "created"
}

302

Redirect to a short-lived object-specific download URL.

Headers

Location

string format: uri

default

Standard error envelope.

application/json

object

error

required

object

code

required

string

message

required

string

request_id

required

string

Example

{
  "error": {
    "code": "quota_exceeded"
  }
}