Bricklink-API
Die Standard-Bibliothek von JayMo bietet bereits einen fast vollständigen Zugriff auf die API von BrickLink. Damit haben Shop-Betreibern Zugriff auf Artikel, Bestellungen, Feedback, Coupons und mehr.
Vorbereitungen
Eigene IP ermitteln
Für den Zugriff auf Bricklink wird die IP-Adresse des aktuellen Internet-Anschlusses benötigt. Also die Adresse, mit welcher der Router aus dem Internet erreichbar ist. Aktuell unterstützt Bricklink nur IPv4.
Zum ermitteln der IP existieren viele Möglichkeiten und unzählige Webseiten. Hier eine Auswahl:
- https://www.ionos.de/tools/ip-adresse
- https://nordvpn.com/de/what-is-my-ip/
- https://www.wieistmeineip.de/
Die IPv4-IP sieht in etwa so aus (Beispiel): 88.123.231.132
In den meisten Fällen wird vom Provider täglich eine neue IP zugewiesen.
API freischalten
Nach dem Einloggen auf Bricklink lässt sich auf der folgenden Seite oben der Zugriff auf die API registrieren: https://www.bricklink.com/v2/api/register_consumer.page
Dabei erhält man "ConsumerKey" und "ConsumerSecret". Diese werden für den Zugriff auf die API benötigt.
Achtung
Bitte die Consumer-Daten vertraulich behandeln und NICHT weitergeben!
IP registrieren
Auf der selben Seite dann unten unter ("Add Access token") die vorhin ermittelte IP eintragen:
- Die "IP Address" in die ersten 4 Felder eintragen: _ . _ . _ . _
- Die "IP Mask" bleibt auf 255.255.255.255
- "Add"
Nun sollte über der Eingabe ein neuer Eintrag mit "TokenValue", "TokenSecret" und den soeben eingegebenen Daten erscheinen.
Auf diese Weise lässt sich also eine neue IP eintragen, bzw. mit "delete" ein Eintrag wieder löschen.
Zugriff mit JayMo
Nun mit JayMo-Edit oder mit einem beliebigen Editor eine Skript-Datei mit folgendem Inhalt erstellen:
CONSUMER_KEY = ""
CONSUMER_SECRET = ""
TOKEN_VALUE = ""
TOKEN_SECRET = ""
BRICKLINK = BrickLinkAPI
BRICKLINK.setConsumer( CONSUMER_KEY, CONSUMER_SECRET )
BRICKLINK.setToken( TOKEN_VALUE, TOKEN_SECRET )
Zwischen die Anführungszeichen der 4 Konstanten am Anfang, müssen nun die entsprechenden Schlüssel eingefügt werden.
Ab nun ist der Zugang eingerichtet.
Unterhalb dieser Zeilen kann nun über die Konstante "BRICKLINK" auf die BrickLink-Datenbank zugegriffen werden.
Wichtig
BrickLink erlaubt nur maximal 5000 API-Zugriffe pro Tag!
Bei Überschreiten wird der Zugang gesperrt und kann nur über den Support wieder freigeschaltet werden!