Warenkorb
Übersetzung
Anmelden/Login
logo

API: file_import

>> zurück zur Liste aller Schnittstellen

Beschreibung Upload von Angebots- oder Bilddateien
URL https://api.booklooker.de/2.0/file_import?token=REST_API_TOKEN
REST_API_TOKEN = Der von der Authentifizierung zurückgelieferte Token.
Methode POST
Version 2.0

Request Body

Die hochzuladende Datei, übergeben als multipart/form-data im Feld file. Der Dateiname muss für Angebotsdateien auf .zip, .txt, .tab, .csv oder .xls enden, für Bilddateien auf .zip.

Ihre Angebotsdatei können Sie entweder als Textdatei oder als komprimiertes ZIP-Archiv übergeben. Standardmäßig müssen die Textdateien in der Kodierung ISO 8859-1 vorliegen. Wenn Ihre Daten in einer anderen Kodierung, bspw. UTF-8 vorliegen, verwenden Sie bitte den Parameter encoding.

Bilddateien müssen als ZIP-Archiv übergeben werden. Weitere Hinweise finden Sie auf der Seite zum manuellen Hochladen. Die hochgeladenen Dateien werden in der Reihenfolge des Uploads verarbeitet.

Maximale Dateigröße: 80 MB.

Parameter

Name Beschreibung Optional? Default-Wert
fileType Dateityp, mögliche Werte:
  • pic · Bilddatei
  • article · Angebotsdatei
 Ja article
dataType Art des Uploads, mögliche Werte:
  • 0 · Hinzufügen/ändern/Löschen
  • 1 · Ersetzen
  • 2 · Löschen
 Nein –
mediaType Medientyp, mögliche Werte:
  • 0 · Bücher
  • 1 · Filme
  • 2 · Musik
  • 3 · Hörbücher
  • 4 · Spiele
 Ja 0
formatID Interne ID des Formats, legt Feldreihenfolge und Texttrenner fest. Für das booklooker-Format verwenden Sie bitte den Wert 1, für mehr Informationen wenden Sie sich bitte an daten@booklooker.de. Ohne Angabe wird das Format des letzten Uploads verwendet. Ja –
encoding Character Encoding der Datei, mögliche Werte:
  • IBMPC/CR (= CP-437)
  • macintosh (= Mac OS Roman)
  • UTF-8
 Ja Es wird das Encoding des letzten Uploads verwendet, beim Erst-Upload CP-1252.

Rückgabe

Status Rückgabewert Beschreibung
OK SUCCESS Upload erfolgreich.
NOK INVALID_PARAMETERS Einer der Parameter fileType, dataType oder mediaType wurde nicht oder mit einem falschen Wert übergeben.
NOK FORMAT_ID_MISMATCH Die Kombination der Werte der Parameter formatID und mediaType kann nicht verarbeitet werden.
NOK FILE_MISSING Es wurde keine Datei übertragen.
NOK MAX_SIZE_EXCEEDED Die maximal erlaubte Dateigröße wurde überschritten.
NOK INVALID_FILE_TYPE Falscher Dateityp.
NOK UPLOAD_FAILED Der Upload der Datei ist fehlgeschlagen.
NOK REPLACE_AMOUNT_EXCEEDED Uploads im Ersetzen-Modus sind bei einem Angebotsbestand > 1.000.000 Artikel nur in Absprache möglich. Bitte wenden Sie sich an daten@booklooker.de
NOK IDENTICAL_FILE_UPLOADED Die Datei ist bereits im System vorhanden.
NOK QUEUE_FULL Die Warteschlange der hochgeladenen Dateien ist voll – entweder mehr als 200 Dateien oder mehr als 250 MB.
NOK ENCODING_ERROR Die Rückgabe enthält ungültige Zeichen.
NOK INVALID_INTERFACE Es wurde eine ungültige Schnittstelle verwendet.
NOK INVALID_REQUEST_METHOD Die Schnittstelle wurde mit einer ungültigen HTTP-Methode aufgerufen.
NOK QUOTA_EXCEEDED Die maximale Anzahl Abfragen/Minute wurde überschritten.
NOK SERVER_DOWN Aufgrund von Wartungsarbeiten ist die REST API momentan nicht verfügbar.
NOK TEMPORARILY_BLOCKED Der Zugang wurde vorübergehend gesperrt, bitte wenden Sie sich an unseren Kundensupport.
NOK TOKEN_EXPIRED Der Token ist nicht mehr gültig, eine erneute Authentifizierung ist notwendig.
NOK TOKEN_MISSING Der Token ist leer oder nicht vorhanden.
NOK TOKEN_UNKNOWN Der Token wurde nicht gefunden.