Carica una risorsa immagine raster uploading-an-image-asset-or-a-vector-asset
Prima di poter caricare una risorsa immagine o vettoriale, richiedete una chiave segreta condivisa. Usate questa chiave segreta condivisa per ottenere un token di caricamento Quindi utilizzi il token di caricamento per caricare le risorse di immagini raster.
Richiedi una chiave con segreto condiviso requesting-a-shared-secret-key
Richiedi una chiave con segreto condiviso da utilizzando l'Admin Console per creare un caso di supporto. Nel caso del supporto tecnico, richiedere una chiave con segreto condiviso.
Nel messaggio e-mail, fornite il nome della società che desiderate usare per caricare le risorse immagine. Dopo aver ricevuto la chiave da Adobe Dynamic Media Classic, salvarla localmente per utilizzarla in futuro.
Recuperare il token di caricamento retrieving-the-upload-token
L’utilizzo di un token di caricamento fa sì che nessuno debba usare la chiave segreta condivisa per caricare le risorse. Garantisce inoltre la legittimità del caricamento e la provenienza da una fonte affidabile.
Il token di caricamento è una stringa alfanumerica disponibile solo per un periodo di tempo limitato. Utilizza i seguenti URL, sostituendo la chiave con segreto condiviso, in modo da poter recuperare il token di caricamento.
- Immagine raster
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
In questo esempio, la chiave con segreto condiviso èfece4b21-87ee-47fc-9b99-2e29b78b602
Per impostazione predefinita, il token di caricamento scade cinque minuti (300 secondi) dopo averlo ottenuto. Per richiedere più tempo, includi expires
nell'URL e il tempo necessario in secondi. Ad esempio, con il seguente URL immagine di esempio si ottiene un token di caricamento che sarà valido per 1800 secondi:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800
La risposta corretta per le immagini è simile alla seguente:
<?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>
Salvate localmente il token di caricamento per poterlo usare per richieste future.
Per ottenere un token di caricamento, potete usare i seguenti campi nella stringa URL di richiesta:
URL immagine raster di esempio:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Metodi HTTP consentiti:GET
e POST
Ora potete caricare una risorsa immagine.
Consulta Caricare una risorsa immagine.
Carica una risorsa immagine raster uploading-an-image-asset
Dopo aver recuperato un token di caricamento valido per un periodo di tempo specificato, potete caricare una risorsa immagine. Potete caricare la risorsa come POST multiparte o modulo e inviare gli altri valori come una stringa di richiesta URL, come nell’esempio di seguito:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
I campi upload_token
e company_name
sono obbligatori.
Consulta Recuperare il token di caricamento.
Vedi Recuperare una chiave con segreto condiviso.
Potete anche inviare altri valori facoltativi come stringhe di richiesta URL, come nell’esempio di seguito:
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
Il parametro file_limit
specifica il limite di dimensione file in byte. Il parametro file_exts
specifica le estensioni del nome file consentite per il caricamento. Entrambi questi valori sono facoltativi.
Nell’applicazione è possibile impostare un limite globale per la dimensione dei nomi file e le estensioni di file consentite. Se quello che hai inviato nella richiesta è un sottoinsieme dei limiti globali, viene rispettato. I limiti globali sono indicati di seguito:
Il seguente modulo HTML consente a un utente di caricare una risorsa. Il modulo richiede l’inserimento delle informazioni di seguito:
- Nome dell'azienda.
- Un token di caricamento.
- Un limite di dimensione file.
- Un elenco di estensioni del nome file.
- Specifica se mantenere il profilo colore e il nome file associati alla risorsa.
- Specifica se utilizzare uno sfondo di foratura. Se attivate Sfondo foratura (Knockout Background), impostate i metodi Angolo (Corner), Tolleranza (Tolerance) e Riempimento (Fill).
Consulta Sfondo foratura in Opzioni di ottimizzazione immagine al caricamento. - Nome del file da caricare.
Puoi visualizzare il codice sorgente HTML associato al modulo precedente selezionando https://s7ugc1.scene7.com/ugc/upload.html
In Firefox, fare clic con il pulsante destro del mouse nella finestra del browser, quindi selezionare Visualizza pagina Source. Il codice mostra la stringa di query URL corrispondente e il metodo POST eseguito quando l'utente seleziona Invia.
Per visualizzare la risposta XML in Internet Explorer, passa a Visualizza > Source. Per visualizzare la risposta XML in Firefox, passa a Strumenti > Strumenti browser > Strumenti sviluppatore Web. Per la visualizzazione delle risposte XML si consiglia Firefox.
Segue un esempio di risposta a seguito di un caricamento riuscito:
<?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>
La risorsa è come qualsiasi altra risorsa Image Server ed è possibile applicarvi delle query di elaborazione. Ad esempio, l’URL seguente richiede una risorsa che sia estesa alla larghezza e all’altezza specificate.
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
Inviate la risorsa come POST multiparte o modulo mentre inviate gli altri valori come una stringa query URL. Nella stringa query URL potete usare i seguenti campi per caricare una risorsa:
op
upload_token
company_name
file_limit
file_exts
preserve_colorprofile
preserve_filename
URL campione:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Metodo HTTP consentito:
POST
Ottieni metadati risorsa per immagini getting-asset-metadata-for-images
È possibile utilizzare image_info
per recuperare i metadati di una risorsa caricata, come illustrato nell'esempio seguente:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Un esempio di risposta corretta è simile al seguente:
<?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>
Nella stringa query URL potete usare i seguenti campi per richiedere informazioni su una risorsa:
op
shared_secret
image_name
URL campione:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Metodo HTTP consentito:
GET e POST