Per-object sia:// share URLs for direct-from-Sia playback.

GET

/api/v1/playback/{id}/share

Authorization

bearerAuth

headerAuthorizationBearer <token>

A Sluby API key (sluby_...) sent as Authorization: Bearer <key>. Keys carry scopes: upload, read, manage.

id*string

Asset UUID or pb_ playback ID.

expires_in?integer

Default3600

renew?string

Set (any value) when replacing a map the player already holds during one watch, so it is not counted as another play. The SDK sets it.

Share URL map.

application/json

master_object_id?string

The HLS master object id (hex).

shares?

Map of Sia object id (hex) to a short-lived sia:// share URL the browser player resolves + downloads directly, no backend proxy.

expires_at?string

Formatdate-time

Example Request

curl -X GET 'https://sluby.example.com/api/v1/playback/string/share'

Example ResponseSchema

{  "master_object_id": "string",  "shares": {    "property1": "string",    "property2": "string"  },  "expires_at": "2019-08-24T14:15:22Z"}