Ö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. I fallet med teknisk support begär du en delad-hemlig nyckel.

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

Överföringstoken ser till 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.

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 tar du med expires i URL:en och den tid du behöver 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åtna HTTP-metoder:
GET och POST

Du kan nu överföra en bildresurs.

Se Överför 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

Fälten upload_token och company_name är obligatoriska.

Se Hämta överföringstoken.

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

Parametern file_limit anger gränsen för filstorlek i byte. Parametern file_exts 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 skickade i begäran är en delmängd av de globala begränsningarna, 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:

Du kan visa HTML-källkoden som är kopplad till formuläret ovan genom att välja https://s7ugc1.scene7.com/ugc/upload.html

Högerklicka i webbläsarfönstret i Firefox och välj sedan View Page Source. Koden visar motsvarande URL-frågesträng och POST-metoden 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:

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:

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