Skip to main content

Get asset URLs

GET 

/iguides/:iguideId/asset-urls

Returns media asset URLs for a view of an iGUIDE, organized by language, and download URLs for completed ADS work orders.

Pass viewId to select a specific view; otherwise it defaults to the iGUIDE's default view. A view belonging to a different iGUIDE is rejected. The ads URLs describe the iGUIDE as a whole and are the same for every view.

Only completed ADS work orders appear in ads. One that is still in production is absent, and is indistinguishable here from one that was never ordered.

Some of the returned URLs carry an authtoken query parameter and stop working once it expires: after 2 weeks for media URLs, or after 2 hours if the requested view is Protected, and after 3 weeks for the ads download URLs. The remaining URLs are public and do not expire. Which URLs are tokenized depends on the iGUIDE and may change, so treat any URL bearing an authtoken as short-lived and re-request this endpoint for fresh ones rather than storing them.

Requires scope: iguide.read.

Request

Responses

Successfully retrieved asset URLs