Nurama Developers
PublicAssetLinks

Resolve a public asset link to embed-player file paths

Returns the HLS streaming manifest keyPath and a fallback original-media keyPath for the asset behind a public download token. Used by the in-iframe embeddable player at /public/{token}/embed. The frontend resolves keyPaths against `VITE_NURAMA_FILE_BASEPATH` and uses HLS.js to play the `.m3u8` manifest when `streamKeyPath` is present, falling back to the original media file otherwise. `video`, `audio`, `3d` and `document` assets embed: a 3D asset plays its processed `media` model (`mediaKeyPath`), and a document fetches its viewer PDF from `/public-download/{token}/document-view`. Other media types return paths for completeness but aren't embedded. No authentication required. Returns minimal file info — never the full asset record (no `id`, `files`, `creatorId`, etc.).

GET
/public-download/{token}/embed-files

Returns the HLS streaming manifest keyPath and a fallback original-media keyPath for the asset behind a public download token. Used by the in-iframe embeddable player at /public/{token}/embed.

The frontend resolves keyPaths against VITE_NURAMA_FILE_BASEPATH and uses HLS.js to play the .m3u8 manifest when streamKeyPath is present, falling back to the original media file otherwise. video, audio, 3d and document assets embed: a 3D asset plays its processed media model (mediaKeyPath), and a document fetches its viewer PDF from /public-download/{token}/document-view. Other media types return paths for completeness but aren't embedded.

No authentication required. Returns minimal file info — never the full asset record (no id, files, creatorId, etc.).

Path Parameters

token*string

The 10-character alphanumeric public download token.

Match^[a-zA-Z0-9]{10}$

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/public-download/Ab3dEf9HiJ/embed-files"
{  "fileName": "my-video.mp4",  "mediaType": "video",  "mode": "embed-download",  "streamKeyPath": "/workspaces/abc/assets/123/stream/index.m3u8",  "mediaKeyPath": "/workspaces/abc/assets/123/media/my-video.mp4",  "posterKeyPath": "/workspaces/abc/assets/123/customThumbnail/large.jpg?v=019e10aa-0000-7000-8000-000000000002",  "waveformKeyPath": "/workspaces/abc/assets/123/waveform/peaks.json",  "storyboard": {},  "storyboardFiles": [    {      "name": "string",      "keyPath": "string"    }  ]}