Chargement d’une ressource d’image matricielle uploading-an-image-asset-or-a-vector-asset

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. Utilisez ensuite le jeton de chargement pour charger des ressources d’images pixellisées.

Demander une clé secrète partagée requesting-a-shared-secret-key

Demandez une clé secrète partagée en ​ à l’aide d’Admin Console pour créer un dossier de support. Dans le cas du support technique, demandez une clé secrète partagée.

Dans le message électronique, indiquez le nom d’entreprise que vous voulez utiliser pour transférer les fichiers d’image. Après avoir reçu la clé d’Adobe Dynamic Media Classic, enregistrez-la localement pour une utilisation ultérieure.

Récupérer le jeton de chargement retrieving-the-upload-token

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é secrète partagée afin de récupérer le jeton de chargement.

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 indiquez 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 pour les images ressemble à ce qui 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 :

Exemple d’URL d’image matricielle :

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.

Chargement d’une ressource d’image matricielle uploading-an-image-asset

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

Les champs 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 paramètre 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 autorisées pour le 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 ce que vous avez envoyé dans la requête est un sous-ensemble des limites globales, cela est respecté. Les limites globales sont les suivantes :

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 HTML associé au formulaire ci-dessus en sélectionnant https://s7ugc1.scene7.com/ugc/upload.html

Dans Firefox, cliquez avec le bouton droit de la souris dans la fenêtre du navigateur, puis sélectionnez Afficher la page Source. Le code affiche la chaîne de requête d’URL correspondante et la méthode POST exécutée lorsque l’utilisateur sélectionne 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>

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 une ressource qui est étirée à 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 :

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

Obtention des métadonnées de ressource pour les images getting-asset-metadata-for-images

Vous pouvez utiliser image_info pour récupérer les métadonnées d’une ressource que vous avez chargée, comme illustré dans l’exemple suivant :

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Un exemple de réponse réussie se présente 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>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 :

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