Shotstash
API referenceREST referenceShare

Next page of a share grid

One more page of files or Sections with signed media URLs. PUBLIC links need nothing; PRIVATE links need the share cookie from unlock.

Try the REST routes against the public demo at https://demostash.aldyernesto.my.id. Get a read-only token (valid for 60 minutes), then paste it as the Bearer token in the console of any route.

GET/s/{slug}/itemsNo try-it console: the demo answers cross-origin requests on /api only.

One more page of files or Sections with signed media URLs. PUBLIC links need nothing; PRIVATE links need the share cookie from unlock.

Authorization

ShareCookie
cookieshotstash_share_{slug}<token>

Access to a PRIVATE share link, set by POST /s/{slug}/unlock and scoped to /s/{slug}. The real cookie name ends with the link slug. PUBLIC links need no cookie.

Path Parameters

slug*string

Share link slug.

Query Parameters

offset?number

Items to skip.

limit?number

Page size, 1 to 60 (default 12).

section?string

Section id to page inside (project links).

sort?string

Sort id: name, date, size, type for files; number, name, count for Sections.

Response Body

The page

application/json
  1. response
files*array<>

Files of the page (empty when the page lists Sections).

sections*array<>

Sections of the page (project links without a drill-in only).

total*number

Items in the whole list.

curl -X GET "https://example.com/s/string/items"
{  "files": [    {      "id": "string",      "name": "string",      "kind": "image",      "sizeBytes": 0,      "sizeText": "string",      "thumbnailUrl": "string",      "inlineUrl": "string",      "downloadUrl": "string",      "duration": "string"    }  ],  "sections": [    {      "id": "string",      "number": "string",      "title": "string",      "fileCount": 0,      "repThumbs": [        "string"      ]    }  ],  "total": 0}

Download a ZIP GET

A ZIP of a whole folder (folderId) or of chosen files (fileIds) of one project; streamed without compression.

Sign share media again POST

Mints fresh signed URLs for files and optionally the ZIP and the thumbnails (signed URLs expire). PUBLIC links need nothing; PRIVATE links need the share cookie from unlock.