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. Per ottenere il codice di caricamento usate i seguenti URL sostituendo la chiave segreta condivisa.
-
Immagine
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
In questo esempio, la chiave segreta condivisa è
fece4b21-87ee-47fc-9b99-2e29b78b602
.
-
Vettoriale
https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9
In questo esempio, la chiave segreta condivisa è
2d19f60e-890a-4e79-a1a5-9ac2875429b9
.
Per impostazione predefinita, il token di caricamento scade cinque minuti (300 secondi) dopo averlo ottenuto. Per richiedere più tempo, includete nell’URL il parametro
expires
e il tempo desiderato, 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 si presenta come di seguito:
<?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:
Parametro URL
|
Richiesto o facoltativo
|
Valore
|
op
|
Obbligatorio
|
get_uploadtoken
|
shared_secret
|
Obbligatorio
|
Chiave segreta condivisa della società che esegue il caricamento.
|
expires
|
Facoltativo
|
Validità del token di caricamento, in secondi. Se non viene specificato, viene applicato il valore predefinito di 300 secondi.
|
URL immagine campione:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Esempio di URL vettoriale:
http://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9&expires=5000
Metodi HTTP consentiti:
GET e POST
Ora potete caricare una risorsa immagine.
Consultate
Caricamento di una risorsa immagine
.