...
La syntaxe générale d’appel est /api/wedia/dam/variation/<asset>/<variations>.
<asset> peut être spécifié deux deux manières
<type>/<id>ou plus récémment ( 11.26+ ) par son uuid<uuid>.<variations> est une liste de noms de variations séparés par des virgules et triés par préférence descendante. ex : thumbnail,watermark,poster,default. Cette liste est évaluée de gauche à droite. La première variation qui est à la fois disponible et autorisée est retournée au demandeur.
La liste des variations disponibles et autorisées pour un asset peut être interrogée par l’api /api/wedia/dam/variations/<asset>.
...
Les prévisualisations en dataview / dataedit sont généralement faites par MediaCloud qui a sa propre configuration. Cette dernière peut être pilotée par la configuration EVP dans l’administration WEDIA /admin/ebnAdministration.ebn
...
Sécuriser l’accès aux variations
Les variations sont sécurisées par le domaine/action : objectfile / sendfile. Cette action permet de sécuriser tous les types de variations : variation de binaire, presets projets, variations de média, players. La distinction entre ces différents types de variation se fait par le paramètre typeOp. subTypeOp contient le nom de la variation, du preset ou du player.
Filtrer la liste des variations disponibles
L’api /api/wedia/dam/variations/xxx permet de lister toutes les variations disponibles pour un média et autorisées par le demandeur. C’est donc une API très utile et utilisée pour proposer des boutons / liens de téléchargement et est notammement utilisée par le backoffice pour lister les variations disponibles dans le fileview. Même si rien n’interdit le téléchargement de certaines variations, il est parfois nécessaire de filtrer ces liens pour ne pas les proposer au téléchargement ( variations techniques ).
Ex :
...
Ce filtrage est possible par une règle de sécurité variation / view. Cette action a les mêmes paramètres que objectfile / sendfile ce qui permet de mutualiser certains traitements par des macros.
Intégration
Lister les variations disponibles d'un asset
...