When uploading videos through a method other than the console, it is possible to request a callback to a third party to notify them when a video has been processed and is ready for viewing. One scenario that demonstrates this method is using the upload widget to upload media assets through a third party CMS and then use the callback to that system to provide confirmation once the asset has been processed and is ready for consumption. Another scenario is using automated XML ingest of media assets through an automated process.
To configure a callback an Account Administrator can:
- Go to Manage this Account in the top-right menu
- select the Third Party Integration tab to display the following window:
- add the base URL
- click Save.
As long as there is a base URL a callback will be attempted after ANY video in the account gets uploaded and processed. In the following example:
The URL that will be called is:>
The parameters passed are:
|id||entity id (internal id in Viostream, i.e. d4065f5b-3300-427a-9e33-dfc674b6173b)|
|referenceId||"key" returned in the upload widget events (i.e. 02bc64f7-f48c-4da8-a4d0-717f801a98a9.mp4). If using ftp ingest this can be passed in as a parameter and used as a customer's own id. When an asset is uploaded through the console this will be the same as publicKey.|
|publicKey||this is the same public key used for embeds that comes back in the API response as "key" (i.e. bq45napbq5c1kc)|
You can use either
referenceId to query the asset details through the API.