ADITUS/Assets

Assets

Please prefer using this API section over the deprecated theme API.

The Assets API serves static content for our products, such as images, tickets and receipts, as well as theming information.

Generally there are two kinds of assets: public and protected.
Protected assets include ticket and receipts while others are public.
In addition to the identifier, protected assets require a security hash in form of a query parameter to be accessible.
The security hash is already contained in links to assets provided by other parts of the API.

Contexts

Most assets are identified via their type. This is, however, not a unique identifier, as these assets can exist in different contexts.
For example the shop banner (THEME_SHOP_BANNER_LARGE), can be defined on different levels, such as mandator, event or article group and is then displayed on the according pages.
Contexts can specify on which level the asset shall be retrieved.
This is done in the format type:identifier.

Available contexts are listed below, though not every context is available on every endpoint.

ContextTypeAvailable identifiers
Mandatornone - implicit
FaireventeventURL alias/slug, UUID
FairbrandfairbrandFairbrand number
Fairevent appearanceappearanceFairevent appearance number, UUID
ExhibitorexhibitorUUID
ArticlearticleUUID
Article GrouparticleGroupUUID
Order PositionorderItemOrder position number, UUID

Subsections#sub

Endpoints#endpoints