Warenkorb
Übersetzung
Anmelden/Login
logo

API: account

>> zurück zur Liste aller Schnittstellen

Beschreibung

Liefert das Anbieterkonto, zu dem der Token gehört, und gibt an, ob dieses Konto Angebote der angegebenen Medienart einstellen kann. So lässt sich vor einem Datei-Upload prüfen, ob alle Voraussetzungen erfüllt sind.

Geprüft wird dasselbe wie beim Einstellen von Angeboten auf der Website: Verifizierung des Kontos, steuerliche Angaben, Verkaufssperre, Versandkosten für die Medienart und angebotene Zahlungsarten.

URL https://api.booklooker.de/2.0/account?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
mediaType Medientyp, für den die Versandkosten geprüft werden, mögliche Werte:
  • 0 · Bücher
  • 1 · Filme
  • 2 · Musik
  • 3 · Hörbücher
  • 4 · Spiele
 Ja 0

Rückgabe

Status Rückgabewert Beschreibung
OK

Die Rückgabe ist ein Objekt mit diesen Elementen:

Element Bedeutung
sellerId Interne ID des Anbieters
username Benutzername des Anbieters (Login-Name)
readyToSell true, wenn das Konto Angebote der angegebenen Medienart einstellen kann, sonst false
missing Liste der Gründe, die dem Einstellen entgegenstehen; leer, wenn readyToSell true ist. Mögliche Einträge:
  • ACCOUNT_NOT_VERIFIED · Das Konto muss noch verifiziert werden.
  • TAX_DATA_MISSING · Die erforderlichen steuerlichen Angaben fehlen.
  • SELLING_BLOCKED · Das Konto darf derzeit keine Artikel anbieten.
  • SHIPPING_COSTS_MISSING · Für die Medienart sind keine Versandkosten hinterlegt.
  • PAYMENT_METHODS_MISSING · Es sind keine angebotenen Zahlungsarten hinterlegt.
NOK INVALID_PARAMETERS Der Parameter mediaType wurde mit einem falschen Wert übergeben.
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.