Ö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.

IMPORTANT
Från och med 1 maj 2023 kommer UGC-resurser i Dynamic Media att vara tillgängliga för användning upp till 60 dagar från överföringsdatumet. Efter 60 dagar tas resurserna bort.
NOTE
Stöd för nya eller befintliga UGC-vektorresurser i Adobe Dynamic Media Classic upphörde den 30 september 2021.

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-2e29b78b602I det här exemplet är nyckeln med delad hemlighet fece4b21-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-parameter
Obligatoriskt eller valfritt
Värde
op
Obligatoriskt
get_uploadtoken
shared_secrets
Obligatoriskt
Den delade hemliga nyckeln för det företag som gör överföringen.
förfaller
Valfritt
Antal sekunder som överföringstoken är giltig. Standardvärdet är 300 sekunder om inget anges.

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.

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

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:

Global gräns
Värde
Filstorlek för alla klienter
20 MB
Bildfilformat som stöds för överföring
BMP, GIF, JPG, PNG, PSD, TIFF

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>
NOTE
Den överförda resursen (JPG, GIF och så vidare) konverteras till PTIFF-format och svaret skickar en direkt länk till den PTIFF-resursen.

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:

URL-parameter
Obligatoriskt eller valfritt
Värde
op
Obligatoriskt
ladda upp
upload_token
Obligatoriskt
Överför token för den delade hemliga nyckeln som är associerad med företaget.
company_name
Obligatoriskt
Namnet på det företag som utför överföringen.
file_limit
Valfritt
Filstorleksgräns i byte för resursen.
file_exts
Valfritt
Lista över tillåtna tillägg för bildresursfilen.
preserve_colorprofile
Valfritt
Bevarar inbäddad färgprofil när den överförda filen konverteras till PTIFF-format. Möjliga värden är true eller false. Standardvärdet är false.
preserve_filename
Valfritt
Bevarar filnamnet för den överförda resursen. Möjliga värden är true eller false. Standardvärdet är false.
NOTE
Du måste skicka resursen som ska överföras som det enda fältet i en begäran om flera POSTER.

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:

URL-parameter
Obligatoriskt eller valfritt
Värde
op
Obligatoriskt
image_info
shared_secret
Obligatoriskt
Den delade hemliga nyckeln för företaget.
image_name
Obligatoriskt
Bildens namn.

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

recommendation-more-help
ba789e76-bace-4e0e-bd26-52691fb2cb26