Creating Public Links for Assets
By default, the Sardius Control Panel will generate a public URL for an asset connected with a player. In the event that you just want a specific media link without a player (for example, for use in a custom-built Roku application or website), this article will guide you on how to create these links.
These public links interface with our Sardius Watch Worker, a background service that will redirect these public links to our storage links, which are randomly generated per asset in accordance with our security policies.
This worker will redirect these public URLs to the correct asset, ensuring that asset stats are properly recorded and registered. Also, if your asset has a VTT file associated with it, it will automatically include that VTT file when the public link is accessed.
How to Search by Type
Add a query parameter to the URL called type. The value you enter should be the file type you want to find. If the file extension you provide is found in the asset's files or media, it will be returned. Examples could be:
- mp3
- mp4
- thumbnail
- This type is the only special use case where we do not check by file extension, but we check if isDefault is true for the file. If so, then we return that specific file. If none is found, no file will be returned.
Examples
With each Public Link, replace {accountID} and the designated query parameter (ex. {assetID}) with the values without brackets. See the examples for the recommended usage.
Asset ID
- TEMPLATE:https://watch.sardius.media/assets/{accountId}/id/{assetId}
- EXAMPLE: https://watch-alpha.sardius.media/asset/-F3gEki2EeAOjKwDl8iC/id/1CFCcAA74C7b865a86F3C9F8a2EA
Asset PID
- TEMPLATE:https://watch.sardius.media/assets/{accountId}/id/{assetPID}
- EXAMPLE: https://watch-alpha.sardius.media/asset/-F3gEki2EeAOjKwDl8iC/id/gpr
Asset mp4
- TEMPLATE:https://watch.sardius.media/assets/{accountId}/id/{assetId}?type=mp4
- EXAMPLE: https://watch-alpha.sardius.media/asset/-F3gEki2EeAOjKwDl8iC/id/1CFCcAA74C7b865a86F3C9F8a2EA?type=mp4
Asset mp3
- TEMPLATE:https://watch.sardius.media/assets/{accountId}/id/{assetId}?type=mp3
- EXAMPLE: https://watch-alpha.sardius.media/asset/-F3gEki2EeAOjKwDl8iC/id/1CFCcAA74C7b865a86F3C9F8a2EA?type=mp3
Asset thumbnail
- TEMPLATE:https://watch.sardius.media/assets/{accountId}/id/{assetId}?type=thumbnail
- EXAMPLE: https://watch-alpha.sardius.media/asset/-F3gEki2EeAOjKwDl8iC/id/1CFCcAA74C7b865a86F3C9F8a2EA?type=thumbnail
Asset m3u8 with VTT
- TEMPLATE:https://watch.sardius.media/assets/{accountId}/id/{assetId}
- EXAMPLE: https://watch-alpha.sardius.media/asset/-F3gEki2EeAOjKwDl8iC/id/1CFCcAA74C7b865a86F3C9F8a2EA