Överföra en rasterbildsresurs uploading-an-image-asset-or-a-vector-asset
Innan du kan överföra en bildresurs måste du först begära en delad hemlig nyckel. Du använder den här delade hemliga nyckeln för att hämta en överföringstoken. Du använder sedan överföringstoken för att överföra rasterbildsresurser.
Begär en delad hemlig nyckel requesting-a-shared-secret-key
Begär en delad-hemlig nyckel av med Admin Console för att skapa ett supportärende. Begär en delad hemlig nyckel i ditt supportfall.
I e-postmeddelandet anger du det företagsnamn som du vill använda för att överföra bildresurser. När du har fått nyckeln från Adobe Dynamic Media Classic sparar du den lokalt för framtida bruk.
Hämta överföringstoken retrieving-the-upload-token
The överföringstoken säkerställer att ingen kan använda samma delade hemliga nyckel för att överföra resurser. Den ser till att överföringen är giltig och kommer från en betrodd källa.
Överföringstoken är en alfanumerisk sträng som bara är tillgänglig under en viss tidsperiod. Använd följande URL:er och ersätt din delade hemliga nyckel så att du kan hämta överföringstoken.
- Rasterbild
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
I det här exemplet är nyckeln med delad hemlighetfece4b21-87ee-47fc-9b99-2e29b78b602
Som standard upphör överföringstoken att gälla fem minuter (300 sekunder) efter att du har hämtat den. Om du vill ha mer tid kan du inkludera expires
i URL:en och hur länge du behöver det i sekunder. Följande exempelbild-URL hämtar till exempel en överföringstoken som är giltig i 1 800 sekunder:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800
Svaret för bilder ser ut ungefär som följande:
<?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>
Spara överföringstoken lokalt för framtida förfrågningar.
Du kan använda följande fält i fråge-URL-strängen för att hämta en överföringstoken:
URL för exempelrasterbild:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Tillåt HTTP-metoder:GET
och POST
Du kan nu överföra en bildresurs.
Överföra en rasterbildsresurs uploading-an-image-asset
När du har hämtat en överföringstoken som är giltig under en viss tid kan du överföra en bildresurs. Du överför resursen som en multipart-/formulärpost medan du skickar resten av värdena som en URL-frågesträng, vilket visas i det här exemplet:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
The upload_token
och company_name
fält är obligatoriska.
Se Hämta en delad-hemlig nyckel.
Du kan också skicka andra valfria värden som URL-frågesträngar, som i det här exemplet:
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
The file_limit
-parametern anger gränsen för filstorlek i byte. The file_exts
parameter anger de filnamnstillägg som tillåts för överföring. Båda dessa värden är valfria.
I programmet anges en global gräns för filstorlek och tillåtna filnamnstillägg. Om det du skickar i begäran är en delmängd av de globala gränserna respekteras det. De globala begränsningarna är följande:
I följande HTML-formulär kan en användare överföra en resurs. I formuläret uppmanas användaren att ange följande information:
- Ett företagsnamn.
- En överföringstoken.
- En gräns för filstorlek.
- En lista med filnamnstillägg.
- Anger om färgprofilen och filnamnet som är associerade med resursen ska bevaras.
- Om du vill använda Blockera bakgrund. Om du aktiverar Blockera bakgrund anger du hörn-, tolerans- och fyllningsmetod.
Se Blockera bakgrund i Alternativ för finjustering av bilder vid överföring. - Namnet på filen som ska överföras.
Du kan visa källkoden för HTML som är kopplad till formuläret ovan genom att välja https://s7ugc1.scene7.com/ugc/upload.html
I Firefox högerklickar du i webbläsarfönstret och väljer sedan View Page Source. Koden visar den motsvarande URL-frågesträngen och den POST-metod som körs när användaren väljer Submit.
Om du vill visa XML-svaret i Internet Explorer går du till View > Source. Om du vill visa XML-svaret i Firefox går du till Tools > Browser Tools > Web Developer Tools. Firefox rekommenderas för visning av XML-svar.
Nedan följer ett exempelsvar från en slutförd överföring:
<?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>
Resursen är som vilken annan ImageServing-resurs som helst. Du kan använda bearbetningsfrågor på den. Följande URL begär till exempel en resurs som är utsträckt till den angivna bredden och höjden.
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
Skicka resursen som ska överföras som en multipart-/formulärpost samtidigt som resten av värdena skickas som en URL-frågesträng. Du kan använda följande fält i URL-frågesträngen för att överföra en resurs:
op
upload_token
company_name
file_limit
file_exts
preserve_colorprofile
preserve_filename
Exempel-URL:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Tillåten HTTP-metod:
POST
Hämta metadata för bildobjekt getting-asset-metadata-for-images
Du kan använda image_info
för att hämta metadata för en resurs som du har överfört, vilket visas i följande exempel:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Ett exempel på ett lyckat svar ser ut ungefär så här:
<?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>
Du kan använda följande fält i URL-frågesträngen för att begära information om en resurs:
op
shared_secret
image_name
Exempel-URL:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Tillåten HTTP-metod:
GET och POST