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 a gedeelde-geheime sleutel door gebruikend Admin Console om een steungeval tot stand te brengen. In het geval van de technische steun, verzoek een gedeeld-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
Het uploadt teken zorgt ervoor dat niemand de zelfde delen-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.
- Rasterafbeelding
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602In dit voorbeeld, is de gedeelde-geheime sleutelfece4b21-87ee-47fc-9b99-2e29b78b602
Standaard verloopt het uploadtoken vijf minuten (300 seconden) nadat u het hebt opgehaald. Als u meer tijd wilt aanvragen, neemt u expires op in de URL en neemt u de hoeveelheid tijd op 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:
het roosterbeeld URL van de steekproef:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Toegestane methodes van HTTP:GET en POST
U kunt nu een afbeeldingselement uploaden.
Zie een beeldactiva 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 velden upload_token en company_name zijn vereist.
Zie het uploadteken terugwinnen.
Zie een gedeelde-geheime sleutel terugwinnen.
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 parameter file_limit geeft de maximale bestandsgrootte op in bytes. De parameter file_exts geeft de bestandsextensies op 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:
- Een bedrijfsnaam.
- Een token voor uploaden.
- Een maximale bestandsgrootte.
- Een lijst met bestandsextensies.
- Of het kleurprofiel en de bestandsnaam die aan het element zijn gekoppeld, behouden moeten blijven.
- Of een uitneemachtergrond wordt gebruikt. Als u Achtergrond uitnemen inschakelt, stelt u de Hoek, Tolerantie en Vulmethode in.
Zie Achtergrond van het Uitnemen in Beeld fijnafstemmen opties bij upload . - The name of the file to upload.
U kunt de broncode van HTML bekijken verbonden aan de vorm hierboven door https://s7ugc1.scene7.com/ugc/upload.html te selecteren
Klik in Firefox met de rechtermuisknop in het browservenster en selecteer vervolgens View Page Source . De code toont de corresponderende URL-queryreeks en de POST-methode die worden uitgevoerd wanneer de gebruiker Submit selecteert.
Ga naar View > Source om de XML-reactie in Internet Explorer weer te geven. Ga naar Tools > Browser Tools > Web Developer Tools om de XML-reactie in Firefox weer te geven. 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:
opupload_tokencompany_namefile_limitfile_extspreserve_colorprofilepreserve_filenameSteekproef URL:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Toegestane methode van HTTP:
POST
Metagegevens van elementen ophalen voor afbeeldingen getting-asset-metadata-for-images
U kunt image_info gebruiken 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:
opshared_secretimage_nameSteekproef URL:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Toegestane methode van HTTP:
GET en POST