Een rasterafbeeldingselement uploaden uploading-an-image-asset-or-a-vector-asset

Voordat u een afbeeldingselement kunt uploaden, vraagt u eerst om een sleutel voor een gedeeld geheim. U gebruikt deze sleutel voor gedeeld geheim om een token voor uploaden op te halen. Vervolgens gebruikt u het token voor uploaden om rasterafbeeldingselementen te uploaden.

Een gedeelde geheime sleutel aanvragen requesting-a-shared-secret-key

Verzoek om een gedeelde geheime sleutel door het gebruiken van de Admin Console om een steungeval tot stand te brengen. In het geval van de technische steun, verzoek om een gedeelde geheime sleutel.

Geef in het e-mailbericht de bedrijfsnaam op die u wilt gebruiken om afbeeldingselementen te uploaden. Nadat u de sleutel van Adobe Dynamic Media Classic ontvangt, bewaar het plaatselijk voor toekomstig gebruik.

Het uploadtoken ophalen retrieving-the-upload-token

De uploadtoken zorgt ervoor dat niemand de zelfde gedeelde geheime sleutel kan gebruiken om activa te uploaden. Het zorgt ervoor dat de upload legitiem is en uit een vertrouwde bron komt.

Het uploadtoken is een alfanumerieke tekenreeks die alleen voor een bepaalde hoeveelheid tijd beschikbaar is. Gebruik de volgende URL's, waarbij u de sleutel voor een gedeeld geheim vervangt, zodat u het token voor uploaden kunt ophalen.

Standaard verloopt het uploadtoken vijf minuten (300 seconden) nadat u het hebt opgehaald. Als u meer tijd wilt aanvragen, neemt u expires in de URL en de tijd die u nodig hebt, in seconden. Met de volgende voorbeeld-URL van de afbeelding wordt bijvoorbeeld een uploadtoken opgehaald dat 1800 seconden geldig is:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800

De geslaagde reactie voor afbeeldingen ziet er ongeveer als volgt uit:

<?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>

Sla het token voor uploaden lokaal op voor gebruik met toekomstige aanvragen.

U kunt de volgende velden in de URL-queryreeks gebruiken om een token voor uploaden op te halen:

Voorbeeld van URL van rasterafbeelding:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600

Toegestane HTTP-methoden:
GET en POST

U kunt nu een afbeeldingselement uploaden.

Zie Een afbeeldingselement uploaden.

Een rasterafbeeldingselement uploaden uploading-an-image-asset

Nadat u een uploadtoken hebt opgehaald dat gedurende een bepaalde periode geldig is, kunt u een afbeeldingselement uploaden. U uploadt het element als multipart/form post terwijl het verzenden van de rest waarden als URL vraagkoord, zoals aangetoond in dit voorbeeld:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

De upload_token en company_name velden zijn vereist.

Zie Het uploadtoken ophalen.

Zie Een sleutel van een gedeeld geheim ophalen.

U kunt ook andere optionele waarden verzenden als URL-querytekenreeksen, zoals in dit voorbeeld:

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

De file_limit parameter geeft de maximale bestandsgrootte op in bytes. De file_exts parameter geeft de bestandsextensies aan die mogen worden geüpload. Beide waarden zijn optioneel.

Er wordt een algemene limiet ingesteld in de toepassing voor de maximale bestandsgrootte en de toegestane bestandsextensies. Als wat u in het verzoek verzendt een ondergroep van de globale grenzen is, wordt het gehonoreerd. De globale limieten zijn als volgt:

Met het volgende HTML-formulier kan een gebruiker een element uploaden. In het formulier wordt de gebruiker gevraagd de volgende gegevens in te voeren:

U kunt de aan het bovenstaande formulier gekoppelde broncode van de HTML weergeven door https://s7ugc1.scene7.com/ugc/upload.html

Klik in Firefox met de rechtermuisknop in het browservenster en selecteer View Page Source. De code toont het overeenkomstige URL vraagkoord en de methode van de POST die in werking wordt gesteld wanneer de gebruiker selecteert Submit.

Ga naar View > Source. Ga naar Tools > Browser Tools > Web Developer Tools. Firefox wordt aanbevolen voor het weergeven van XML-reacties.

Hier volgt een voorbeeldreactie van een geslaagde upload:

<?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>

Het middel is als om het even welke andere bron ImageServing; u kunt verwerkingsvragen op het toepassen. De volgende URL vraagt bijvoorbeeld om een element dat naar de opgegeven breedte en hoogte wordt uitgerekt.

https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

Verzend het element dat u wilt uploaden als multipart/form-post terwijl u de overige waarden verzendt als een URL-queryreeks. U kunt de volgende velden in de URL-queryreeks gebruiken om een element te uploaden:

URL voorbeeld:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

Toegestane HTTP-methode:

POST

Metagegevens van elementen ophalen voor afbeeldingen getting-asset-metadata-for-images

U kunt image_info om metagegevens op te halen voor een element dat u hebt geüpload, zoals in het volgende voorbeeld wordt getoond:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Een voorbeeld van een succesvolle reactie lijkt op het volgende:

<?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>

U kunt de volgende velden in de URL-queryreeks gebruiken om informatie voor een element op te vragen:

URL voorbeeld:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Toegestane HTTP-methode:

GET en POST