🔗

Passer aux URL signées

En bref

Vous utilisez déjà les anciennes URL cloudphoto ? Reprenez leurs transformations dans les paramètres v2, signez chaque URL sur votre serveur, puis comparez le résultat avant de remplacer les liens de votre intégration. Les deux formes d’URL restent acceptées.

🔎Reconnaître une ancienne URL

Une URL v1 place l’opération, la taille et les filtres dans son chemin :

https://cdn.cloudphoto.io/{token}/{operation}/{taille}/{filtres}/{adresse-source}

La v2 place ces réglages dans les paramètres qui suivent /img.webp :

https://cdn.cloudphoto.io/{token}/img.webp?{parametres}&sig={signature}&url={adresse-source}

Conservez le token de votre application et l’adresse source complète, y compris ses propres paramètres. Le secret associé au token sert à calculer la signature ; il reste sur votre serveur. Si vous ne disposez plus du secret de votre application, utilisez le formulaire « Contactez-nous » avant de basculer, sans y transmettre de secret.

📐Transposer la taille et le cadrage

Reprenez explicitement l’opération v1 avec le paramètre fit. Les mêmes noms gardent le même type de cadrage :

Ancien chemin	Paramètres v2	Résultat attendu
`width/420`	`fit=width&w=420`	Largeur de 420 pixels, proportions conservées
`height/300`	`fit=height&h=300`	Hauteur de 300 pixels, proportions conservées
`crop/420x300`	`fit=crop&w=420&h=300`	Cadre rempli avec rognage
`cover/420x300`	`fit=cover&w=420&h=300`	Dimensions exactes, déformation possible
`fit/420x300`	`fit=fit&w=420&h=300`	Image entière, espace restant rempli
`bound/420x300`	`fit=bound&w=420&h=300`	Image entière, sans remplissage
`none/none`	`fit=none`	Aucun redimensionnement

Ne rajoutez pas de multiplicateur dpr pendant cette première comparaison : il augmenterait les dimensions demandées. Vous pourrez ensuite adapter la densité à votre affichage.

🎨Reprendre les filtres et le point d’ancrage

Si le segment de filtres v1 vaut none, omettez fx. Sinon, reprenez les filtres compatibles dans fx, séparés par des points et dans le même ordre. Le point d’ancrage peut être extrait dans g : gravitySouthEast.brightness140 devient g=SouthEast&fx=brightness140.

Pour les couleurs de remplissage ou les effets, comparez le rendu sur vos images de référence : la v2 apporte aussi de nouveaux réglages. Le guide Redimensionner, recadrer et filtrer une image décrit les cadrages et la syntaxe des effets.

✍️Construire et signer l’URL v2

1. Assemblez les paramètres de transformation.

2. Ajoutez url= et l’adresse source complète en dernier.

3. Calculez la signature avec le secret de la même application.

Appliquez la recette de Construire et signer une URL d’image : HMAC-SHA256 de la chaîne exacte, 16 premiers octets, puis Base64 compatible URL sans remplissage.

4. Insérez sig= avant url= sans modifier les autres paramètres.

Pour essayer la conversion sans secret, le token public de démonstration accepte cette source. Ces deux URL demandent une largeur de 420 pixels :

https://cdn.cloudphoto.io/demo/width/420/none/https://samples-photos.com/tennis.jpg
https://cdn.cloudphoto.io/demo/img.webp?fit=width&w=420&url=https://samples-photos.com/tennis.jpg

🔒

La démonstration est une exception. Avec le token de votre application, une URL v2 sans signature valide est refusée. Ne placez jamais le secret dans le navigateur.

🧪Comparer le rendu avant de basculer

Les mêmes dimensions ne garantissent pas un fichier identique. Vérifiez les différences suivantes :

Format et qualité : la v2 choisit par défaut un format adapté au navigateur et une qualité propre à ce format. Pour une première comparaison proche de la v1, demandez f=original&q=91, puis resignez l’URL ; cela ne garantit pas un rendu identique.
GIF animés : la v1 les livre sans transformation. La v2 peut les redimensionner et les convertir en WebP animé. Demandez f=original pour conserver le format GIF ; les dimensions demandées restent appliquées.
SVG : les deux versions livrent la source sans transformation.
Cache : une URL v2 peut nécessiter la production d’une nouvelle variante, même si la v1 a déjà servi cette source. Sa première lecture peut donc être plus lente.

Comparez les dimensions, le cadrage, les couleurs, la transparence et l’animation sur quelques images représentatives. Le guide Choisir le format et la qualité aide à ajuster le résultat. Si une image manque, suivez Diagnostiquer une image qui ne s’affiche pas.

🚀Remplacer progressivement les anciennes URL

1. Activez la génération d’URL v2 sur une page ou un lot d’images limité.

2. Vérifiez l’affichage et les réponses dans « Logs » pour l’application concernée.

3. Étendez la v2 lorsque le rendu est validé.

Gardez temporairement votre génération d’URL v1 pour pouvoir revenir au comportement précédent. La migration ne demande pas de supprimer l’application ni ses anciennes variantes : les deux grammaires peuvent coexister avec le même token.

Mise à jour le 24 septembre 2026