Hochladen eines Rasterbild-Assets uploading-an-image-asset-or-a-vector-asset
Bevor Sie ein Bild-Asset hochladen können, fordern Sie zunächst einen gemeinsamen geheimen Schlüssel an. Mit diesem gemeinsamen geheimen Schlüssel können Sie ein Upload-Token abrufen. Anschließend verwenden Sie das Upload-Token, um Rasterbild-Assets hochzuladen.
Anfordern eines gemeinsamen geheimen Schlüssels requesting-a-shared-secret-key
Anfordern einer shared-secret key von Verwenden der Admin Console, um einen Support-Fall zu erstellen. Bitten Sie in Ihrem Support-Fall um einen gemeinsam genutzten geheimen Schlüssel.
Geben Sie in der E-Mail-Nachricht den Unternehmensnamen an, den Sie verwenden möchten, um Bild-Assets hochzuladen. Nachdem Sie den Schlüssel von Adobe Dynamic Media Classic erhalten haben, speichern Sie ihn lokal für die zukünftige Verwendung.
Upload-Token abrufen retrieving-the-upload-token
Das Upload-Token stellt sicher, dass niemand denselben gemeinsamen geheimen Schlüssel zum Hochladen von Assets verwenden kann. Außerdem stellt es sicher, dass der Upload zulässig ist und von einer vertrauenswürdigen Quelle stammt.
Das Upload-Token besteht aus einer alphanumerischen Zeichenfolge, die nur für eine begrenzte Zeitspanne gültig ist. Verwenden Sie die folgenden URLs und ersetzen Sie den gemeinsam genutzten geheimen Schlüssel, damit Sie das Upload-Token abrufen können.
- Rasterbild
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
In diesem Beispiel lautet der gemeinsame geheime Schlüsselfece4b21-87ee-47fc-9b99-2e29b78b602
Standardmäßig läuft das Upload-Token 5 Minuten (300 Sekunden) nach dem Abrufen ab. Um mehr Zeit anzufordern, schließen Sie expires
in der URL und die benötigte Zeit in Sekunden. So wird bei der folgenden URL für ein Beispielbild ein Upload-Token abgerufen, das 1800 Sekunden gültig ist:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800
Die erfolgreiche Antwort für Bilder sieht in etwa wie folgt aus:
<?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>
Speichern Sie das Upload-Token für zukünftige Anfragen lokal.
Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Abrufen eines Upload-Tokens verwenden:
Beispiel-Rasterbild-URL:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Zulässige HTTP-Methoden:GET
und POST
Sie können nun ein Bild-Asset hochladen.
Siehe Bild-Asset hochladen.
Hochladen eines Rasterbild-Assets uploading-an-image-asset
Wenn Sie ein Upload-Token abgerufen haben, das für eine bestimmte Zeitspanne gültig ist, können Sie ein Bild-Asset hochladen. Sie laden das Asset mit der POST-Methode als mehrteilige Formulardaten hoch, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden, wie im nachfolgenden Beispiel gezeigt:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Die upload_token
und company_name
-Felder erforderlich sind.
Siehe Upload-Token abrufen.
Siehe Abrufen eines gemeinsamen geheimen Schlüssels.
Sie können auch andere optionale Werte als URL-Anfragezeichenfolgen senden, wie das nachfolgende Beispiel zeigt:
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
Die file_limit
gibt die maximale Dateigröße in Byte an. Die file_exts
gibt die Dateinamenerweiterungen an, die hochgeladen werden dürfen. Diese beiden Werte sind optional.
In der Anwendung sind globale Beschränkungen für die maximale Dateigröße und zulässigen Dateierweiterungen festgelegt. Wenn es sich bei der von Ihnen gesendeten Anforderung um eine Untergruppe der globalen Beschränkungen handelt, wird diese berücksichtigt. Die globalen Beschränkungen lauten wie folgt:
Mit dem folgenden HTML-Formular können Benutzer Assets hochladen. In dem Formular wird der Benutzer aufgefordert, die folgenden Informationen einzugeben:
- Ein Unternehmensname.
- Ein Upload-Token.
- Eine Dateigrößenbeschränkung.
- Eine Liste der Dateinamenerweiterungen.
- Gibt an, ob das Farbprofil und der Dateiname des Assets beibehalten werden sollen.
- Ob Hintergrund aussparen verwendet werden soll. Wenn Sie "Hintergrund aussparen"aktivieren, legen Sie die Methode "Ecke", "Toleranz"und "Füllung"fest.
Siehe Hintergrund aussparen in Bildoptimierungsoptionen beim Hochladen. - Der Name der hochzuladenden Datei.
Sie können den mit dem obigen Formular verknüpften HTML-Quellcode anzeigen, indem Sie https://s7ugc1.scene7.com/ugc/upload.html
Klicken Sie in Firefox mit der rechten Maustaste in das Browserfenster und wählen Sie Seitenquelle anzeigen. Der Code zeigt die entsprechende URL-Abfragezeichenfolge und die POST-Methode an, die ausgeführt werden, wenn der Benutzer Einsenden.
Um die XML-Antwort in Internet Explorer anzuzeigen, navigieren Sie zu Ansicht > Quelle. Um die XML-Antwort in Firefox anzuzeigen, navigieren Sie zu Instrumente > Browser-Tools > Web Developer Tools. Zur Anzeige von XML-Antworten wird Firefox empfohlen.
Hier eine Beispielantwort für einen erfolgreiche 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>
Das Asset kann wie jede andere Image-Server-Ressource gehandhabt werden; Sie können auch Verarbeitungsanfragen darauf anwenden. Beispielsweise fordert die folgende URL ein Asset an, das bis zur angegebenen Breite und Höhe gestreckt ist.
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
Senden Sie das hochzuladende Asset mit der POST-Methode als mehrteilige Formulardaten, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden. Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Hochladen eines Assets verwenden:
op
upload_token
company_name
file_limit
file_exts
preserve_colorprofile
preserve_filename
Beispiel-URL:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Zulässige HTTP-Methode:
POST
Abrufen von Asset-Metadaten für Bilder getting-asset-metadata-for-images
Sie können image_info
, um Metadaten für ein hochgeladenes Asset abzurufen, wie im folgenden Beispiel gezeigt:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Ein Beispiel für eine erfolgreiche Antwort wird in etwa wie folgt angezeigt:
<?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>
Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Abrufen von Informationen für ein Asset verwenden:
op
shared_secret
image_name
Beispiel-URL:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Zulässige HTTP-Methode:
GET und POST