Skip to main content
OCLC Support

Installation REST API V1.7

  1. Letzte Aktualisierung
  2. Als PDF speichern

Allgemeines

Diese Anleitung beschreibt, wie der REST API Webservice installiert wird, damit BIBLIOTHECAplus-Kunden Ihren Leserinnen und Lesern individuelle APPs mit folgenden Funktionen bereitstellen können: Recherche und Detailanzeige von Medien, Anmeldung eines Bibliotheksnutzers, Leserkonto, Services (Verlängern und Vorbestellen von Medien/Exemplaren).

Voraussetzungen

OPEN REST API Version 1.7 setzt den Einsatz von OPEN V11.0 voraus. Sie müssen die Installation mit einem Windows-Benutzer durchführen, der über Administratorrechte verfügt. Es muss das .NET Framework 4.7 installiert sein. 

Installation

Gehen Sie wie folgt vor:

  1. Öffnen Sie die Datei ApiSetup.msi. Das Fenster OCLC OPEN API-Setup erscheint.
  2. Wählen Sie das Installationsverzeichnis.
  3. Klicken Sie auf Weiter.
  4. Geben Sie die Verbindungsdaten zu Ihrer OPEN COP Installation ein.

     Hinweis: Sie können diese Daten in OPEN im Modul OPEN.CopConnector unter Auflistung vorhandener Dienste nachlesen. 

  5. Klicken Sie auf Weiter. Die Einstellungen werden überprüft

  6. Wählen Sie einen Namen für die API-Website aus. Über diesen Namen finden Sie die Website im IIS.

  7. Klicken Sie auf Weiter. Die Installation wird vorgenommen.

  8. Notieren Sie Ihren APIKey. Dieser muss bei jeder Anfrage an die API mitgeliefert werden. Das Verfahren stellt sicher, dass die Schnittstelle nicht von jedem benutzt werden kann.

  9. Öffnen Sie im IIS Ihre API-Website und weisen Sie der HTTPS-Bindung ein Zertifikat zu. Ändern Sie ggf. den Port falls dieser bereits belegt ist.

     Hinweis: Siehe Kapitel Zertifikat einbinden. Sie benötigen ein kostenpflichtiges Zertifikat, da der Dienst von außen aufgerufen wird und die Identität bestätigt sein muss.
    Bitte beachten Sie, dass die Anwendung schreibenden Zugriff auf die Datei ApiKeys.xml benötigt, die sich im Installationsverzeichnis befindet. 

  10. Testen Sie die API durch den Aufruf der URL im Browser: https://127.0.0.1:8316/RESTv1/pickupbranches?APIKey=<IhrAPIKey>
    Alternativ kann hierzu mit dem folgenden Link, in dem das Feld <MedienNr> durch eine existierende Mediennummer ersetzt wird, getestet werden, ob die API aufrufbar ist:
    https://127.0.0.1:8316/RESTv1/catalogues/<MedienNr>?apikey=<IhrAPIKey>

     Hinweis: Eine detaillierte Fehlermeldung im Falle eines Fehlers sehen Sie nicht im Internet Explorer.

Falls Sie den APIKey nicht korrekt angeben erscheint:
{"ErrorMessage":"A valid API key needs to be included using the apikey query string parameter."} 

Falls Sie Ihren Lizenzschlüssel nicht eingegeben haben, erscheint:
{"ErrorMessage":"license check failed"} 

Falls alles korrekt ist, erscheint:
{"ErrorMessage":"not implemented. please use child ressource [/Catalogues/{id}] for specific catalogue information or [/Search] for searching."}

Zertifikat einbinden

Für die Nutzung der API (benutzerspezifische Aktionen) benötigen Sie ein Zertifikat. Sie benötigen ein kostenpflichtiges Zertifikat, da der Dienst von außen aufgerufen wird und die Identität bestätigt sein muss. 

Gehen Sie wie folgt vor:

  1. Öffnen Sie die Internet Information Services (IIS) auf dem betroffenen Server. 
  2. Öffnen Sie den linken Baum des IIS, bis Sie Ihre API-Webseite sehen.
  3. Klicken Sie diese mit der linken Maustaste an. 
  4. Klicken Sie im rechten Fensterbereich auf Bindungen. 
  5. Klicken Sie auf Hinzufügen. 
  6. Machen Sie Ihre Angaben zu IP-Adresse (falls relevant) und Port.
  7. Wählen Sie unter SSL-Zertifikat das gekaufte Zertifikat aus.

     Hinweis: Achten Sie darauf, dass Sie keine Ports doppelt belegen. Verwenden Sie z. B. den Port 8543.