Avant de transférer un fichier d’image, vous devez d’abord demander une clé de secret partagé. Cette clé vous permet de récupérer un jeton de téléchargement. Vous pouvez ensuite utiliser le jeton de chargement pour charger des ressources d’image pixellisée.
À compter du 1er mai 2023, les ressources UGC dans Dynamic Media pourront être utilisées pendant 60 jours à compter de la date de chargement. Au bout de 60 jours, les ressources seront supprimées.
La prise en charge de ressources vectorielles UGC nouvelles ou existantes dans Adobe Dynamic Media Classic s’est terminée le 30 septembre 2021.
Demander une clé secrète partagée par utilisation du Admin Console pour créer un cas d’assistance. Dans votre cas de prise en charge, demandez une clé de secret partagé.
Dans le message électronique, indiquez le nom d’entreprise que vous voulez utiliser pour transférer les fichiers d’image. Une fois que vous avez reçu la clé d’Adobe Dynamic Media Classic, enregistrez-la localement pour une utilisation ultérieure.
Le jeton de téléchargement garantit que personne d’autre que vous n’utilisera la même clé de secret partagé pour télécharger des fichiers. Il garantit le caractère légitime et la fiabilité de la source du téléchargement.
Le jeton de téléchargement est une chaîne numérique uniquement disponible pendant une durée limitée. Utilisez les URL suivantes, en substituant votre clé de secret partagé, afin que vous puissiez récupérer le jeton de chargement.
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
Dans cet exemple, la clé de secret partagé est fece4b21-87ee-47fc-9b99-2e29b78b602
Par défaut, le jeton de téléchargement arrive à expiration au terme d’un délai de cinq minutes (300 secondes) après sa récupération. Pour demander plus de temps, incluez expires
dans l’URL et le temps nécessaire en secondes. Par exemple, l’URL d’image suivante permet de récupérer un jeton de téléchargement valide pendant 1 800 secondes :
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800
La réponse réussie des images s’affiche comme suit :
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>get_uploadtoken</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title>
<message>
<uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken>
<expiration_in_seconds>1800</expiration_in_seconds>
</message>
</response>
</user_generated_content>
</scene7>
Enregistrez le jeton de téléchargement sur l’ordinateur pour l’utiliser avec les futures requêtes.
Vous pouvez utiliser les champs suivants dans l’URL de requête pour récupérer un jeton de téléchargement :
Paramètre de l’URL | Obligatoire ou facultatif | Valeur |
---|---|---|
op | Obligatoire | get_uploadtoken |
shared_secret | Obligatoire | La clé de secret partagé de l’entreprise qui procède au téléchargement. |
expires | Facultatif | Durée de validité (en secondes) du jeton de téléchargement. Valeur par défaut : 300 secondes. |
Exemple d’URL d’image pixellisée :
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Méthodes HTTP autorisées :
GET
et POST
Vous pouvez maintenant transférer un fichier d’image.
Voir Chargement d’une ressource image.
Après avoir récupéré un jeton de téléchargement valide pendant une durée limitée, vous pouvez télécharger un fichier d’image. Vous téléchargez le fichier en tant que publication de formulaire ou publication en plusieurs parties tout en envoyant le reste des valeurs en tant que chaîne de requête d’URL, comme dans cet exemple :
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Le upload_token
et company_name
sont obligatoires.
Voir Récupération du jeton de chargement.
Voir Récupération d’une clé secrète partagée.
Vous pouvez également envoyer d’autres valeurs facultatives comme chaînes de requête d’URL, comme dans cet exemple :
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif
Le file_limit
spécifie la limite de taille de fichier en octets. Le paramètre file_exts
spécifie les extensions de nom de fichier admises pour le téléchargement. Ces deux valeurs sont facultatives.
Une limite globale est définie dans l’application pour la taille limite des fichiers et les extensions de nom de fichier autorisées. Si le contenu de votre requête se trouve dans les limites globales, celle-ci est satisfaite. Les limites globales sont les suivantes :
Limite globale | Valeur |
---|---|
Taille du fichier pour tous les clients | 20 Mo |
Formats de fichiers d’image pris en charge pour le téléchargement | BMP, GIF, JPG, PNG, PSD, TIFF |
Le formulaire HTML suivant permet à un utilisateur de télécharger un fichier. L’utilisateur est invité à entrer les informations suivantes :
Vous pouvez afficher le code source du HTML associé au formulaire ci-dessus en sélectionnant https://s7ugc1.scene7.com/ugc/upload.html
Dans Firefox, cliquez avec le bouton droit dans la fenêtre du navigateur, puis sélectionnez Afficher la source de page. Le code affiche la chaîne de requête d’URL correspondante et la méthode POST qui sont exécutées lorsque l’utilisateur clique sur Envoyer.
Pour afficher la réponse XML dans Internet Explorer, accédez à Affichage > Source. Pour afficher la réponse XML dans Firefox, accédez à Outils > Outils de navigateur > Outils de développement web. Firefox est recommandé pour afficher les réponses XML.
Vous trouverez ci-dessous un exemple de réponse à un téléchargement réussi :
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>upload</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Your file has been uploaded Successfully.</title>
<message>
<url>https://s7w2p1.scene7.com/is/image/ </url>
<path>000Company/ugc/1442564.tif</path>
<fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
</message>
</response>
</user_generated_content>
</scene7>
le fichier téléchargé (JPG, GIF, etc.) est converti au format PTIFF et un lien direct vers ce fichier PTIFF est envoyé dans la réponse.
Ce fichier est semblable à n’importe quelle autre ressource ImageServing ; vous pouvez lui appliquer des requêtes de traitement. Par exemple, l’URL suivante demande un fichier étiré à la largeur et à la hauteur spécifiées.
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
Envoyez le fichier à télécharger en tant que publication de formulaire ou en plusieurs parties tout en envoyant le reste des valeurs en tant que chaîne de requête d’URL. Vous pouvez utiliser les champs suivants dans la chaîne de requête d’URL pour télécharger un fichier :
Paramètre de l’URL | Obligatoire ou facultatif | Valeur |
---|---|---|
op |
Obligatoire | charger |
upload_token |
Obligatoire | Jeton de téléchargement pour la clé de secret protégé associée à l’entreprise. |
company_name |
Obligatoire | Nom de l’entreprise qui réalise le téléchargement. |
file_limit |
Facultatif | Taille limite du fichier (en octets). |
file_exts |
Facultatif | Liste des extensions de fichiers d’image autorisées. |
preserve_colorprofile |
Facultatif | Conservation de tout profil de couleur incorporé avec conversion du fichier téléchargé au format PTIFF. Les valeurs possibles sont vrai ou faux. La valeur par défaut est faux. |
preserve_filename |
Facultatif | Conservation du nom du fichier téléchargé. Les valeurs possibles sont vrai ou faux. La valeur par défaut est faux. |
vous devez envoyer le fichier à télécharger en tant que champ unique dans la requête POST en plusieurs parties.
Exemple d’URL :
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Méthode HTTP autorisée :
POST
Vous pouvez utiliser image_info
pour récupérer les métadonnées d’un fichier que vous avez téléchargé, comme indiqué dans l’exemple suivant :
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Voici un exemple de réponse réussie :
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>image_info</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>More information on 1442564.tif</title>
<message>
File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
<imageFormat>Tiff</imageFormat>
<colorSpace>Rgb</colorSpace>
<width>686</width>
<height>457</height>
</message>
</response>
</user_generated_content>
</scene7>
Vous pouvez utiliser les champs suivants dans la chaîne de requête d’URL pour demander des informations sur un fichier :
Paramètre de l’URL | Obligatoire ou facultatif | Valeur |
---|---|---|
op |
Obligatoire | image_info |
shared_secret |
Obligatoire | La clé de secret partagé de l’entreprise. |
image_name |
Obligatoire | Nom de l’image. |
Exemple d’URL :
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Méthode HTTP autorisée :
GET et POST