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.
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 sich 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:
| Ja | article |
| dataType | Art des Uploads, mögliche Werte:
| Ja | 1 |
| mediaType | Medientyp, mögliche Werte:
| 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 [email protected] | Ja | n/a (Es wird das Format des letzten Uploads verwendet.) |
| encoding | Character Encoding der Datei (wenn nicht ISO8859-1 / Latin1), mögliche Werte:
| Ja | n/a (Es wird das Encoding des letzten Uploads verwendet.) |
Rückgabe
| Status | Rückgabewert | Beschreibung |
|---|---|---|
| OK | SUCCESS | Upload erfolgreich. |
| NOK | INVALID_PARAMETERS | Einer der Parameter fileType, dataTypeoder mediaTypewurde mit einem falschen Wert übergeben. |
| NOK | FORMAT_ID_MISMATCH | Die Kombination der Werte der Parameter formatIDund mediaTypekann 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 [email protected] |
| 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. |