API: article_list

>> zurück zur Liste aller Schnittstellen

Beschreibung	Liste aller aktiven Artikelnummern. Bitte beachten: Wird ein Artikel gelöscht, so wird dieser nicht sofort aus den aktuell angebotenen Artikel gelöscht, sondern mit einer Verzögerung von im Schnitt 1-2 Stunden. Um den aktuellen Status eines Artikels zu ermitteln, benutzen Sie bitte die Schnittstelle article_status.
URL	https://api.booklooker.de/2.0/article_list ?token=REST_API_TOKEN REST_API_TOKEN = Der von der Authentifizierung zurückgelieferte Token.
Methode	GET
Version	2.0

Beschreibung

Liste aller aktiven Artikelnummern.

Bitte beachten: Wird ein Artikel gelöscht, so wird dieser nicht sofort aus den aktuell angebotenen Artikel gelöscht, sondern mit einer Verzögerung von im Schnitt 1-2 Stunden. Um den aktuellen Status eines Artikels zu ermitteln, benutzen Sie bitte die Schnittstelle article_status.

URL

https://api.booklooker.de/2.0/article_list ?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
field	Rückgabefeld, mögliche Werte: orderNo · Bestellnummer isbn · ISBN ean · EAN	Ja	orderNo
showPrice	Übermittlung des Preises, mögliche Werte: 0 · nein 1 · ja Wird der Parameter showPrice mit dem Wert 1 übergeben, so werden die Artikelpreise TAB-getrennt zurückgegeben.	Ja	0
showStock	Übermittlung des Bestands, mögliche Werte: 0 · nein 1 · ja Wird der Parameter showStock mit dem Wert 1 übergeben, so werden ausschließlich die Bestellnummern und Bestandsangaben der Artikel zurückgegeben, die einen Bestand >1 besitzen. Alle übrigen Parameter (field, showPrice, mediaType) werden in diesem Fall ignoriert.	Ja	0
mediaType	Einschränkung nach Medientyp, mögliche Werte: 0 · Bücher 1 · Filme 2 · Musik 3 · Hörbücher 4 · Spiele	Ja	n/a

Name

Beschreibung

Optional?

Default-Wert

field

Rückgabefeld, mögliche Werte:

orderNo · Bestellnummer
isbn · ISBN
ean · EAN

orderNo

showPrice

Übermittlung des Preises, mögliche Werte:

0 · nein
1 · ja

Wird der Parameter showPrice mit dem Wert 1 übergeben, so werden die Artikelpreise TAB-getrennt zurückgegeben.

showStock

Übermittlung des Bestands, mögliche Werte:

0 · nein
1 · ja

Wird der Parameter showStock mit dem Wert 1 übergeben, so werden ausschließlich die Bestellnummern und Bestandsangaben der Artikel zurückgegeben, die einen Bestand >1 besitzen. Alle übrigen Parameter (field, showPrice, mediaType) werden in diesem Fall ignoriert.

mediaType

Einschränkung nach Medientyp, mögliche Werte:

0 · Bücher
1 · Filme
2 · Musik
3 · Hörbücher
4 · Spiele

n/a

Rückgabe

Status	Rückgabewert	Beschreibung
OK	Eine Liste der Artikelnummern (bzw. ISBN/EAN) aller vom Anbieter aktuell angebotenen Artikel, getrennt mit einem einfachen Zeilenumbruch (\n).
NOK	INVALID_PARAMETERS	Einer der Parameter field oder mediaType wurde mit einem falschen Wert übergeben.
NOK	PARAMETER_MISMATCH	Der Parameter field mit Wert isbn oder ean kann nur verwendet werden, wenn der Parameter mediaType vorhanden ist.
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.

Status

Rückgabewert

Beschreibung

Eine Liste der Artikelnummern (bzw. ISBN/EAN) aller vom Anbieter aktuell angebotenen Artikel, getrennt mit einem einfachen Zeilenumbruch (\n).

NOK

INVALID_PARAMETERS

Einer der Parameter field oder mediaType wurde mit einem falschen Wert übergeben.

NOK

PARAMETER_MISMATCH

Der Parameter field mit Wert isbn oder ean kann nur verwendet werden, wenn der Parameter mediaType vorhanden ist.

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.