API de gestion et traitement des images

Cette page traite des transformations et manipulations disponible sur des images disponibles dans Product-Live. Plus précisément, il s'agit des images associées à un item sur un champ de type IMAGE sur une table donnée.

Remarque

L'outil technique utilisé derrière l'API proposée est imgproxy

Limitations

Attention

Seules les conversions vers les formats JPEG, PNG et WebP sont gérés à date par la plateforme.

Voir le document concernant les limites d'utilisation de la plateforme

Accès à l'image d'origine

Exemple: https://asset.prod.product-live.com/file-map/5f0818d27ef6945715d9bbc7_documents/redirect/8db6d3f2057678aecb94c0b2f98dd7564908fab9b722168bbe18d11b27eb748d

#	Description
https://	Seul le protocole https est disponible
asset.prod.product-live.com	Le domaine utilisé pour la mise à disposition d'asset (image et fichier)
file-map	Permet d'indiquer que l'on souhaite obtenir l'image originalement déposée dans la plateforme (sans altération)
5f0818(...)_documents	Le répertoire dédié au compte sur lequel l'image a été importée
redirect
8db6d3f2057678(...)	l'identifiant unique de l'image

Appliquer des transformations sur une image

Exemple: https://asset.prod.product-live.com/file-map-resize/5f0818d27ef6945715d9bbc7_documents/redirect/8db6d3f2057678aecb94c0b2f98dd7564908fab9b722168bbe18d11b27eb748d?height=300

#	Description
https://	Seul le protocole https est disponible
asset.prod.product-live.com	Le domaine utilisé pour la mise à disposition d'asset (image et fichier)
file-map-resize	Permet d'indiquer que l'on souhaite altérer l'image cible
5f0818d27(...)_documents	Le répertoire dédié au compte sur lequel l'image a été importée
redirect
8db6d3f2057(...)	l'identifiant unique de l'image

Redimensionnement

Exemple: https://asset.prod.product-live.com/file-map-resize/5f0818d27ef6945715d9bbc7_documents/redirect/8db6d3f2057678aecb94c0b2f98dd7564908fab9b722168bbe18d11b27eb748d?height=300

Propriété	Description	Exemple	Rendu
width	Largeur de l'image	/?width=250
height	Largeur de l'image	/?height=250
height et width		/?height=450&width=250

Remarques

Le ratio de l'image est conservé. Un fond blanc recouvre les zones non couvertes par l'image dans le cas où les paramètres de hauteur et de largeur sont mentionnés (voir exemple plus haut).

Conversion

Exemple: https://asset.prod.product-live.com/file-map-resize/5f0818d27ef6945715d9bbc7_documents/redirect/8db6d3f2057678aecb94c0b2f98dd7564908fab9b722168bbe18d11b27eb748d?format=png&quality=20

Seules les conversions vers les formats jpg, png et webp sont supportées.

Propriété	Description	Exemple	Rendu
format	jpg / png / webp, Le format cible de l'image	/?format=png
quality	de 0 à 100, dans le cas d'un jpg, la qualité de l'image	/?quality=20

Les presets

Exemple: https://asset.prod.product-live.com/file-map-resize/5f0818d27ef6945715d9bbc7_documents/redirect/8db6d3f2057678aecb94c0b2f98dd7564908fab9b722168bbe18d11b27eb748d?preset=small

Propriété	Description	Exemple	Rendu
preset	large / medium / small, Le preset cible de l'image	/?preset=small

Preset	Valeurs utilisées	Exemple	Rendu
small	width = 46 height = 46 quality = 90	/?preset=small
medium	width = 200 height = 200 quality = 95	/?preset=medium
large	width = 500 height = 500	/?preset=large

Au sujet des métadonnées associées aux images

Il existe plusieurs types de métadonnées associées aux images:

• IPTC Core & Extension: les informations de base de l'image, comme le copyright, le nom de l'auteur, le nom de l'image, etc.
• Exif: Des informations le plus souvent produites par les appareils photo numériques, comme la date de prise de vue, la position GPS, etc.
• XMP: C'est le format le plus récent. Il permet la création de métadonnées personnalisées.

L'ensemble des métadonnées sont conservées au sein du fichier d'origine et présentes à l'export de celui-ci. Cependant, ces métadonnées ne sont pas transmises à l'image redimensionnée et ne sont donc pas disponibles au sein de celles-ci.

Notes complémentaires

• Plus d'informations techniques sur la configuration des paramètres présentés ci-dessus ici (nécessite d'avoir les accès appropriés pour acceder au projet Product-Live/azure-arm-template)