# 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.

\
![](/files/bvhnyilVsCTpPCmmcjTT)

## 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.

<div data-full-width="true"><figure><img src="/files/q6DLdsKjdsnOweY5DqO7" alt=""><figcaption><p>API Key Konfiguration</p></figcaption></figure></div>

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:

<https://openwowi-demo.wowiport.de/>

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 (<https://kundenname.wowiport.de>). \
Die Endpunkt-URL finden Sie in den einzelnen Abschnitten der Dokumentation.

Beispiel:\
![](/files/AYFk3w0YmVlqQ9gvlaDp)


---

# Agent Instructions: 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:

```
GET https://docs.openwowi.de/grundlagen/einrichtung-openwowi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
