logo

API: article_list

>> zurück zur Liste aller Schnittstellen

Beschreibung Liste aller eigenen 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

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.