Liest man
diese Seite zum ersten Mal, vermisst man eine allgemeinverständliche Anleitung mit Beispielen für Rainer User und Martina Musterfrau. Eingeweihte und Programmier-Erfahrene wissen, was zu tun ist, wir anderen klicken auf „Weiter“.
Also:
Der Buchbestand von Booklooker wird in einer Datenbank verwaltet. Die
Druckübersicht meiner Bücher ist ein verschwindend kleiner Tabellenauszug aus den zig-Tausenden von Fußballfeldern, die die gesamte BL-Datenbank bedecken würde, rollte man sie aus. Wir kratzen mit unseren Inseraten und Sucheingaben ein bisschen an der Oberfläche herum - gleichzeitig laufen im Hintergrund sehr tief tauchende Algorithmen im Kreis herum, um Antworten zu liefern und Käufe/Verkäufe wahr werden zu lassen. Das zu pflegen und in Schuss zu halten, lastet eine IT-Abteilung völlig aus.
Nun gibt es eine sog. „Schnittstelle“, sagen wir mal Steckdose, um diesen Datenbestand erlaubterweise anzuzapfen und (unter gewissen Auflagen) für eigene Zwecke zu verwenden, auszuwerten, am eigenen Computer darzustellen und mit eigenen Anwendungen zu verknüpfen. Das Ding heißt API und eine bestimmte API-Variante heißt REST-API. Wer es genauer wissen will, kann Stunden und Tage auf YouTube verbringen. Ich verlinke davon jetzt nichts. Bleiben wir noch ein bisschen hier am Ball:
Für uns ist von Bedeutung, dass man üblicherweise
1. Ein Computer-Programm braucht, das mit der Steckdose harmoniert und
2. Einen Zugangsschlüssel benötigt, der einen als zugangsberechtigt ausweist.
Ehe jetzt einige auf „Weiter“ klicken:
Punkt 1 lässt sich mit den Kurzbefehlen bewerkstelligen, die wir schon kennengelernt haben und die KEINE Programmierausbildung voraussetzen, weder beim Erstellen noch beim Anwenden.
Punkt 2 heißt API-Key und ist (nach Login ins Konto, dann unter „Persönliche Daten“)
hier zu kriegen. Er sieht zum Beispiel so aus:
29EB26A309C7AB8D3BB3A242C57734C7
Wow! 32 Stellen, die man kopieren und sicher ablegen sollte. Wir brauchen die 32 Zeichen, um sie an der richtigen Stelle in unsere Kurzbefehle einzufügen, genauer: In den Kurzbefehl, den ich verwende. In den Kurzbefehl, den DU verwendest, fügst Du eine andere, nämlich DEINE höchstpersönliche Ziffernfolge ein, DEINEN API-KEY (den niemand sonst kennt, also sowas wie ein Passwort).
Damit das Ganze nicht zu einfach wird, hat die API-Philosophie noch sowas erfunden wie einen zweiten Schlüssel NUR FÜR DIE SITZUNG, das Ding wird TOKEN genannt. Es hat die unangenehme Eigenschaft, nach einer Zeit der Inaktivität sein bisschen Geist aufzugeben - futsch!
Dann sitzt man da mit seinem tollen API-Key (Schlüssel Nummer 1) und kann damit nichts anfangen, außer: Ein neues TOKEN (Schlüssel Nummer 2) anzufordern, das bis zur nächsten Inaktivität gültig ist oder durch Nase-voll und Abgang-ins-Bett vorzeitig geschreddert wird.
Den ersten Kurzbefehl, den wir brauchen, habe ich
„Booq Token“ genannt. Er nimmt den persönlichen (hochgeheimen) API-Key in seine Obhut, schickt die Ziffernfolge an Booklooker, klopft dort an und fragt freundlich, ob er mal eben bitte ein TOKEN mit Verfallsdatum ausleihen darf, um was zu checken in der Riesen-Datenbank.
Überflüssig zu sagen, dass an der Stelle der Pixel (1) ein echter, gültiger API-Key stehen muss, damit das Ganze funzt. Einmal durch copy/paste eingetragen, bleibt er im Kurzbefehl gespeichert.
Ich überspringe die Erklärung der Befehle 2, 3 und 4 (die räumen den erhaltenen Datensalat ein bisschen auf), bis Befehl 5 das pure myTOKEN in die Zwischenablage kopiert, um im nächsten Kurzbefehl ans Eingemachte zu dürfen: „booq REST-API“ heißt er auf meinem Homescreen, kann aber auch mit allem Möglichen beschriftet werden.
Nochmal:
Ein Tipp auf
„Booq Token“ holt die Erlaubnis von Booklooker, für eine Sitzungsdauer in die BL-Datenbank gucken zu dürfen.
Ein Tipp auf
„Booq REST-API“öffnet (nach Eingang der Erlaubnis) ein Auswahlmenü, das wir uns im nächsten Beitrag anschauen.
Ich habe jetzt erstmal fertig, Flasche leer (Zitat des großen Poeten Giovanni Trapattoni, 1998).
Werner
