Überblick

Die EDS API-Console ermöglicht es, die Funktionen der EDS API recht einfach über ein Web-Interface auszuprobieren.
Die Console ist zugänglich unter https://eds-api.ebscohost.com/Console.

Nutzung

(Bitte klicken Sie auf die Bilder für eine größere Darstellung.)

1.

Um mit der Console arbeiten zu können, ist ein Login mit Nutzerdaten notwendig, die speziell für die EDS API ausgestellt wurden: es handelt sich nicht um die Zugangsdaten zur EBSCO Admin-Oberfläche.
Neben Kennung und Passwort muss auch ein "Profil" angegeben werden; in unseren Fällen ist dies stets "edsapi".
Die Auswahl von "y" oder "n" für die Angabe "Guest" entscheidet darüber, ob die vollen oder nur reduzierte Metadaten für die Suchergebnisse angezeigt werden.

2.

Nach dem Login muss zunächst noch eine Sitzung erzeugt werden. Hier wird erneut das Profil ("edsapi") und der Gaststatus abgefragt.
Außerdem gibt es den Parameter "Org", der gewissermaßen den Stellvertreter kennzeichnet, der die Aufrufe im Namen des durch den vorherigen Login ausgewiesenen EDS-Kunden durchführt. Das hbz trägt dort nach Absprache stets den Wert "hbz" ein; wenn sie selbst die Console ausprobieren, können Sie das Feld im Prinzip auch leer lassen (sollte keine Auswirkungen haben).

3.

Danach können Sie über die Navigation links weitere Funktionen aufrufen. Gegenwärtig gibt es keine Anwendungsfälle für die Aufrufe in den Bereichen "Authentication" oder "Publication API".

Suchanfragen führen wir über "*GET* Search" durch. Abweichend von der Vorgaben setzen wir "Highlight" auf "n", "View" auf "detailed" und das "Response Format" auf "JSON".

4.

Nach dem Absenden einer Suche wechselt die Console in den Tab "Response" und Sie sehen die Ergebnisse in einer wenig lesbaren Form vor sich.

5.

Es empfiehlt sich, ein passendes Browser-Plugin - wie etwa "JSONView" für Firefox - zu installieren, das JSON Daten in eine lesbare Form bringt und dazu den Link "Open in new window" anzuklicken.

  • Keine Stichwörter