Concept of Sources

Sources are objects which point to content or, more generally resources, used in Services definition.

If you want to create a Service, you first need to create a Source.

Note that certain Services (such as DAI for instance, require you to create at least two Sources e.g. Live + Ad Server, or, Asset Catalog + Ad Server)

As shown below, there are 5 types of Sources which can be created, updated or deleted through the WebApp or the API.

Source typeDescriptionParameters
Ad ServerA link to an ad server compliant with the VAST or VMAP protocols, which will tell broadpeak.io which ads should be played within an ad placement opportunity, depending on the contextName: must be unique among all sources.
URL: must point to a valid ad server that broadpeak.io can connect to.
Query parameters: static or dynamic variables forwarded from the client request or inserted by broadpeak.io to communicate the context to the Ad Server.
Description: informational only.
Asset CatalogA link to a directory containing DASH and/or HLS VOD assetsName: must be unique among all sources.
URL: the common part of the path of all assets in the catalog. It must end with a /.
Sample: one of the VOD assets contained in the catalog. Combined with the above URL, it must link to a valid DASH or HLS VOD asset for validation purposes.
Backup origin IP: IP address of a backup server used when the primary address is unreachable.
Description: informational only.
AssetA link to a DASH or HLS VOD asset that can be used as content in a Virtual Channel slot or a gap filler in an Ad Insertion serviceName: must be unique among all sources.
URL: must link to a valid DASH or HLS VOD asset.
Backup origin IP: IP address of a backup server used when the primary address is unreachable.
Description: informational only.
LiveA link to a DASH or HLS live channel that can be used as original source in a service or replacement content in a Content Replacement or Virtual Channel serviceName: must be unique among all sources.
URL: must link to a valid DASH or HLS live channel.
Backup origin IP: IP address of a backup server used when the primary address is unreachable.
Description: informational only.
SlateA VOD asset transcoded from a JPEG still picture or an mp4 video, that can be used as gap filler in an Ad Insertion service. Requires a transcoding profile compatible with your live source.Name: must be unique among all sources.
URL: must link to a valid JPEG file (up to 50 MB) or mp4 video (up to 500 MB).
Description: informational only.