🩺
Diagnostiquer une image qui ne s’affiche pas
En bref
Lorsqu’une transformation échoue, cloudphoto sert une image de remplacement et un code de réponse qui indique où chercher. Vérifiez d’abord la source et l’URL signée, puis utilisez les logs de l’application.
🔎Faire les premières vérifications
1. Ouvrez directement l’adresse de l’image source dans un navigateur.
2. Vérifiez que l’URL cloudphoto utilise le bon token et que son chemin se termine par
/img.webp, /img.jpg, /img.jpeg ou /img.png.Toute autre extension renvoie une erreur. La forme
/img sans extension répond aussi, mais le réseau de diffusion ne la met pas en cache : les images sont plus lentes, et chaque affichage est facturé comme un nouveau calcul.3. Vérifiez que
url= est présent et placé en dernier.4. Recalculez la signature après toute modification d’un paramètre ou de l’adresse source.
5. Contrôlez que les dimensions sont positives, que la taille finale ne dépasse pas 10 000 pixels et que les cadrages à deux dimensions reçoivent bien
w et h.Une réponse contenant l’image demandée porte l’indication
Cloudphoto-Status: 1. L’image de remplacement porte Cloudphoto-Status: 0 et n’est pas mise en cache.🚦Interpréter le code de réponse cloudphoto
| Code | Cause la plus fréquente | Vérification utile |
|---|---|---|
403 |
Token inconnu, signature absente ou invalide | Reprendre le token, la chaîne signée et le secret de la même application |
404 |
Image source absente, inaccessible ou corrompue | Ouvrir l’adresse source, puis essayer ponctuellement force=1
|
415 |
Le contenu téléchargé n’est pas une image acceptée | Utiliser une source JPEG, PNG, WebP, HEIC, GIF ou SVG |
503 |
La source refuse temporairement les demandes | Respecter le délai Retry-After avant de réessayer |
500 |
URL ou paramètres invalides, ou erreur inattendue | Reprendre la structure, les dimensions et le cadrage de l’URL |
Ne relancez pas une source indisponible en boucle. Une attente conforme à
Retry-After évite de prolonger un refus temporaire ou d’épuiser davantage son quota.📋Consulter les logs cloudphoto
Dans « Tableau de bord », choisissez l’application avec « Détail », puis ouvrez « Logs ». La page affiche le nombre de requêtes, le taux de cache, le taux d’erreur et le volume livré. Utilisez les filtres de date, de statut ou d’identifiant de requête pour isoler l’appel concerné.
Chaque ligne permet d’ouvrir « Voir la donnée brute ». Comparez l’URL enregistrée avec celle que votre application a construite, en particulier l’ordre des paramètres et l’adresse source terminale.
🧪Demander un rapport de diagnostic
Ajoutez
ci_info=1 avant sig et url, puis recalculez la signature. Lorsque l’image peut être produite, cloudphoto renvoie un rapport à la place de l’image afin de confirmer le format et les transformations retenus.Si l’image de remplacement apparaît encore, fiez-vous au code de réponse : le rapport n’est disponible qu’après une transformation réussie. La documentation technique détaille les paramètres et les exemples d’intégration.
Aktualisiert am 9. September 2026