Lorsque vous envoyez des commandes à GelatoConnect via l’API ou d’autres méthodes, vous devez fournir des liens de téléchargement direct pour vos fichiers d’impression. Ces liens doivent permettre à GelatoConnect de télécharger vos fichiers sans authentification ni intervention de votre part. Ce guide vous explique comment créer des liens de téléchargement direct pour des fichiers stockés sur les services de stockage cloud les plus courants.
Dropbox
Les liens de partage Dropbox se terminent généralement par ?dl=0, ce qui ouvre une page d’aperçu au lieu de télécharger le fichier directement. Pour créer un lien de téléchargement direct :
Obtenez le lien de partage pour votre fichier dans Dropbox
Modifiez la fin de l’URL en passant de
?dl=0à?dl=1
Exemple :
Lien d'origine :
https://www.dropbox.com/s/abcdefg123456/filename.pdf?dl=0Lien de téléchargement direct :
https://www.dropbox.com/s/abcdefg123456/filename.pdf?dl=1
Cette modification indique à Dropbox de lancer un téléchargement immédiatement plutôt que d'afficher une page d'aperçu.
Google Drive
Google Drive nécessite une approche différente pour créer des liens de téléchargement direct :
Obtenez le lien de partage pour votre fichier dans Google Drive (clic droit → Partager → Copier le lien)
Récupérez l’ID du fichier à partir de l’URL (la longue suite de caractères située entre
/d/et/view)Créer une nouvelle URL en utilisant le format suivant :
https://drive.google.com/uc?export=download&id=FILE_ID
Exemple :
Lien d'origine :
https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i0j/view?usp=sharingLien de téléchargement direct :
https://drive.google.com/uc?export=download&id=1a2b3c4d5e6f7g8h9i0j
Remarque : Pour les fichiers volumineux (plus de 100 Mo), Google Drive peut afficher un avertissement concernant l’analyse antivirus. Il se peut que vous deviez confirmer une étape supplémentaire pour finaliser le téléchargement.
OneDrive
Les liens OneDrive peuvent être modifiés pour créer des téléchargements directs :
Obtenir le lien de partage pour votre fichier dans OneDrive
Modifiez l’URL en ajoutant le paramètre
?download=1:
Pour les comptes OneDrive personnels :
Lien d'origine :
https://onedrive.live.com/?authkey=...&cid=...&id=...Lien de téléchargement direct : remplacez
?par?download=1&dans l’URL
Pour les comptes OneDrive professionnels/Microsoft 365 :
Lien d'origine :
https://company-name-my.sharepoint.com/:f:/g/personal/...Lien de téléchargement direct : Ajoutez
?download=1à la fin de l'URL
Bonnes pratiques pour les URL de soumission de commandes
Lorsque vous créez des liens de téléchargement direct pour les fichiers d'impression dans vos demandes de commande GelatoConnect :
Assurez-vous que les fichiers sont correctement accessibles - Les URL doivent être accessibles publiquement sans nécessiter de connexion ou d'authentification
Vérifier l'expiration du lien - Certaines options de partage créent des liens temporaires ; assurez-vous qu'ils n'expireront pas pendant le traitement des commandes (idéalement valides pendant au moins 7 jours)
Testez vos liens - Avant de soumettre votre demande API de commande, vérifiez que le lien de téléchargement direct fonctionne en le testant dans une fenêtre de navigation privée/incognito
Vérifier la compatibilité du format de fichier - Assurez-vous que vos fichiers répondent aux exigences de format de GelatoConnect (généralement PDF pour les fichiers d'impression)
URL au bon format - Assurez-vous que l’URL est correctement indiquée dans le champ "url" de votre tableau "files" dans la requête API.
Stockage permanent - Pour les produits commandés régulièrement, pensez à opter pour une solution de stockage plus durable.
Dépannage des commandes échouées en raison de problèmes d'accès aux fichiers
Si vos commandes échouent à cause d’erreurs d’accès aux fichiers :
Vérifier le statut de la commande - Les commandes avec des fichiers inaccessibles échoueront généralement à la validation avec un message d'erreur spécifique
Vérifiez les autorisations de partage – Assurez-vous que le fichier est réglé sur « Toute personne disposant du lien peut consulter », sans obligation de se connecter
Vérifiez le format de l’URL – Assurez-vous d’avoir bien modifié l’URL comme indiqué ci-dessus.
Testez en mode navigation privée - Ouvrez le lien dans une fenêtre de navigation privée ou incognito pour vérifier qu'il fonctionne sans être connecté(e)
Vérifier l'URL dans la requête - Assurez-vous que l'URL exacte est correctement formatée dans votre requête API
Limitations de taille de fichier - Assurez-vous que votre fichier n'est pas trop volumineux pour les capacités de téléchargement direct du service cloud