API: file_status

>> zurück zur Liste aller Schnittstellen

Beschreibung	Abfragen des Status einer hochgeladenen Angebotsdatei
URL	https://api.booklooker.de/2.0/file_status ?token=REST_API_TOKEN REST_API_TOKEN = Der von der Authentifizierung zurückgelieferte Token.
Methode	GET
Version	2.0

Beschreibung

Abfragen des Status einer hochgeladenen Angebotsdatei

URL

https://api.booklooker.de/2.0/file_status ?token=REST_API_TOKEN
REST_API_TOKEN = Der von der Authentifizierung zurückgelieferte Token.

Methode

GET

Version

2.0

Parameter

Name	Beschreibung	Optional?	Default-Wert
filename	Name der hochgeladenen Datei. Existieren mehrere hochgeladene Dateien mit diesem Namen, bezieht sich der zurückgegebene Wert auf die zuletzt hochgeladene Datei.	Nein	–
showErrors	Der Rückgabewert ist eine Liste von Fehlern, die beim Import der Datei identifiziert wurden. Mögliche Werte: 0 · nur der Status wird zurückgeliefert 1 · Liste von Fehlern, siehe Rückgabe Achtung: Die Liste der Fehler kann nur für komplett verarbeitete Dateien abgefragt werden!	Ja	0

Name

Beschreibung

Optional?

Default-Wert

filename

Name der hochgeladenen Datei.

Existieren mehrere hochgeladene Dateien mit diesem Namen, bezieht sich der zurückgegebene Wert auf die zuletzt hochgeladene Datei.

Nein

–

showErrors

Der Rückgabewert ist eine Liste von Fehlern, die beim Import der Datei identifiziert wurden.

Mögliche Werte:

0 · nur der Status wird zurückgeliefert
1 · Liste von Fehlern, siehe Rückgabe

Achtung: Die Liste der Fehler kann nur für komplett verarbeitete Dateien abgefragt werden!

Rückgabe

Status

Rückgabewert

Beschreibung

FILE_RECEIVED

Die Datei wurde vollständig hochgeladen, aber noch nicht verarbeitet.

UPLOAD_IN_PROGRESS

Die Datei befindet sich aktuell in Verarbeitung.

UPLOAD_DONE

Die Datei komplett verarbeitet.

Sofern der Parameter showErrors mit dem Wert 1 übergeben wurde, ist die Rückgabe eine Liste von Fehlern, welche je Zeile einen Artikel mit diesen Werten enthält:

Spalte

Beschreibung

errorID

ID des Fehlers (siehe unten)

record

Datensatz

orderNo

Bestellnummer

title

Titel (sofern vorhanden)

details

weitere Informationen, warum der Artikel abgelehnt wurde (sofern vorhanden)

errorID kann folgende Werte annehmen:

errorID	Beschreibung
1	Mehrfach vergebene Bestellnummer
2	Mehrfach vorhandene identische Angebote (Dubletten)
3	(wird nicht mehr verwendet)
4	Neubücher in privatem Account
5	Fehlende Formatangabe (z. B. CD, DVD, LP etc.)
6	Hörbuch in Bücherdatei
7	Fehlende oder ungültige FSK-Angabe
8	Nicht unterstützter Artikeltyp
9	(wird nicht mehr verwendet)
10	Das Feld Titel ist leer
11	Das Feld Preis oder Währung ist leer oder wurde nicht gefunden
12	Preis von Neubuch weicht ab vom gebundenen Preis
13	Grenze von 5000 VLB-Artikel überschritten, gesamte Datei wird nicht verarbeitet
14	E-Books sind nicht erlaubt
15	Keine Daten zur ISBN vorhanden
16	FSK 18
17	Maximale Artikelanzahl überschritten
18	Erscheinungsdatum liegt in der Zukunft
19	Preisangaben von 100.000 EUR und darüber werden nicht unterstützt
20	Unerwünschter Verlag
21	Nicht-westeuropäisches Zeichen in Bestellnummer

NOK

INVALID_PARAMETERS

Der Parameter filename ist leer oder nicht vorhanden.

NOK

FILE_NOT_FOUND

Die Datei wurde nicht gefunden.

NOK

UPLOAD_FAILED

Datei konnte nicht eingelesen werden (es wurde kein gültiger Datensatz gefunden).

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.