> For the complete documentation index, see [llms.txt](https://docs.openwowi.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openwowi.de/grundlagen/einrichtung-openwowi.md).
# Einrichtung OPENWOWI
## WOWIPORT-Konfiguration
{% hint style="warning" %}
Um auf die OPENWOWI-Konfiguration zugreifen zu können, wird das Benutzerrecht "OPEN WOWI Konfiguration" benötigt.
{% endhint %}
In dem Menüpunkt "Schnittstellen" unter *Systemverwaltung* >> *Schnittstellen* >> *OPENWOWI Konfiguration* (siehe Screenshot) in WOWIPORT erhalten Sie eine Übersicht über bereits eingerichtete Schnittstellen und können neue Schnittstellen hinzufügen.
\
## Details der Konfiguration
Durch das Anlegen der Konfiguration wird ein individueller API-Key zur Nutzung der Schnittstelle für eine Anwendung erzeugt. Über die Endpunktberechtigungen können Sie steuern, über welche der verschiedenen API-Endpunkte eine Datenausgabe möglich sein soll.
Alle Datenabrufe funktionieren nur in den konfigurierten Buchwerken. Datenabrufe werden auf die Buchwerksauswahl gefiltert.
API Key Konfiguration
Um unsere Beispiele zur Nutzung der API nachvollziehen zu können, können Sie einen Zugang zu unserer Sandbox beantragen. Bitte kontaktieren Sie hierfür [Partnermanagement@drklein-wowi.de](mailto:partnermanagement@drklein-wowi.de).\
Sie erhalten dann einen technischen User und einen API Key. Für die Beantragung **benötigen wir eine E-Mailadresse** (diese wird für die Passwortvergabe an den Benutzer gebunden) für die Versendung der Einladung zu unserer Sandbox und Zustellung des API Keys.
Die URL der Sandbox lautet:
Weiterführende Informationen zur Berechtigungssteuerung finden Sie in den Abschnitten "[Authentifizierung und Berechtigungen](/schnittstelle-v1.x/authentifizierung-und-berechtigungen.md)" in der Schnittstellendokumentation.
Details zur Einrichtung von [Webhooks](/grundlagen/webhooks.md) und der Quelleneinstellungen für das [Kommunikationsmodul](/schnittstelle-v1.x/kommunikationsmodul.md) finden Sie in den jeweiligen Abschnitten.
Details zur Freischaltung von Dokumentenabrufen und der Einrichtung des Tabs für externe DMS Systeme finden Sie im Abschnitt "[Dokumente und Medien](/schnittstelle-v1.x/dokumente-und-medien.md)".
## Nutzung der Endpunkte
Für die Nutzung der Endpunkte müssen Sie eine Route ansprechen, welche sich aus der Basis-URL und der Endpunkt-URL zusammensetzt. Die Basis-URL ist hierbei die URL der Kundeninstanz (). \
Die Endpunkt-URL finden Sie in den einzelnen Abschnitten der Dokumentation.
Beispiel:\
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.openwowi.de/grundlagen/einrichtung-openwowi.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.