# Was können eigene Programme mit Szenera tun?

Dasselbe, was das Portal kann. Die Oberfläche ruft keine geheimen Sonderwege auf, sondern dieselbe Schnittstelle, die auch Ihnen offensteht — mit einem Schlüssel statt einer Anmeldung.

> **Typ:** konzept
> **Für wen:** Technisch versierte Teams, die Szenera an eigene Systeme anbinden, und alle, die dafür Zugänge ausstellen.
> **Voraussetzung:** Das Recht **API-Schlüssel auflisten** oder **API-Schlüssel ausstellen**, beziehungsweise **Webhooks auflisten**. Beide Bereiche gehören zum Paket Premium.
> **Ort im Portal:** **Einstellungen › Organisation › API-Schlüssel** und **Einstellungen › Organisation › Webhooks**

## Sieben Wege

Die API ist der Hauptweg: 395 Operationen auf 310 Pfaden, JSON in beide Richtungen, gewöhnliche Verfahren und gewöhnliche Statuscodes. Jede Route steht in einer Beschreibung nach OpenAPI 3.1, die aus dem Quelltext entsteht und deshalb nicht altert — daraus erzeugen Sie sich einen Klienten in Ihrer Sprache, statt Adressen abzutippen. Listen antworten mit `items`, `total` und `nextCursor`: Den Cursor geben Sie beim nächsten Aufruf zurück, fehlt er, war es die letzte Seite.

Die Kommandozeile `szenera` ist derselbe Weg, nur getippt. Sie ist für Prozesse gebaut und für Menschen benutzbar: Am Terminal kommt eine Tabelle, in einem Skript kommt JSON, und die Exit-Codes trennen die Fehlerarten, damit ein Skript reagieren kann, ohne Text zu vergleichen.

Webhooks drehen die Richtung um. Statt im Takt zu fragen, hinterlegen Sie eine Adresse und die Ereignisse, die Sie angehen. Szenera stellt zu, unterschreibt jede Zustellung und führt ein Zustell-Log, das Sie einsehen können. Die Ereignisnamen tragen Bereich, Gegenstand und Vorgang schon in sich — `composition.scene.published` sagt ohne Nachschlagen, was passiert ist.

Das Apps-SDK ist der vierte Weg: Damit bauen Sie kein Programm neben Szenera, sondern eine eigene App, die im Store steht, im Szenen-Editor auftaucht und auf dem Bildschirm läuft.

![Vier Wege zwischen Ihren Systemen und Szenera: Programm und Skript rufen die API auf, Ereignisse werden an Ihren Empfänger zugestellt, eine eigene App geht in den Katalog](/de/docs/developers/bilder/892db3e7-integration-paths.svg)

_Die Zeichnung zeigt die vier Wege, auf denen Sie selbst etwas bauen. Drei weitere kommen ohne eigenen Bau aus: Bei ihnen bringt ein fremdes Programm schon mit, was es braucht._

**Verbundene Anwendungen** sind der fünfte Weg. Ein fremdes Programm, etwa ein Werkzeug für die Kommandozeile oder eine Anwendung auf Ihrem Rechner, fragt Sie einmal um Erlaubnis, und ab da handelt es in Ihrem Namen, mit genau den Rechten, die Sie ihm gegeben haben. Ihr Passwort bekommt es nie, und Sie nehmen die Erlaubnis mit einem Klick wieder zurück: [Verbundene Anwendungen erlauben und widerrufen](/de/docs/organization/connected-applications).

**KI-Assistenten** sind der sechste. Sie tragen eine Adresse von Szenera ein, melden sich mit Ihrem Konto an, und der Assistent kann Ihren Bestand ansehen und Vorschläge machen. Was auf einem Bildschirm landet, fragt er vorher. Löschen kann er nichts. Der Weg dahinter ist derselbe wie bei einer verbundenen Anwendung.

**Konten aus dem Personalverzeichnis** sind der siebte. Führt Ihre Organisation ein Verzeichnis, legt es die Konten hier an, sperrt sie beim Austritt und setzt die Rollen — niemand pflegt beides doppelt: [Konten aus dem Personalverzeichnis (SCIM)](/de/docs/organization/scim-provisioning).

## Was im Portal geschieht — und was daneben steht

Im Portal erledigen Sie genau zwei Dinge: Sie stellen **API-Schlüssel** aus und Sie legen **Webhook-Endpunkte** an. Beides sitzt im Register **Organisation** der Einstellungen, beides hängt an einem eigenen Recht, und beides gehört zum Paket Premium. Bestehende Schlüssel und Endpunkte arbeiten weiter, auch wenn das Paket später wechselt. Widerrufen, abschalten und löschen können Sie sie ohnehin jederzeit.

Ein Schlüssel ersetzt die Anmeldung, nicht die Rechteprüfung. Seine Rechte wählen Sie je Schlüssel, geerbt wird nichts. Und mehr als Sie selbst dürfen, kann er nie. Das Portal sagt es am Feld **Rechte**.

Zwei der neuen Wege haben auch eine Portal-Seite, aber keinen Knopf zum Anlegen: Eine **verbundene Anwendung** entsteht in der Anwendung selbst und steht danach unter **Einstellungen › Mein Konto › Sicherheit**. Die **Provisionierung** wird unter **Einstellungen › Organisation › Unternehmens-Anmeldung** freigeschaltet und braucht vorher einen aktiven Anmeldeweg über das Firmenkonto.

Alles Weitere ist keine Portal-Aufgabe und steht deshalb nicht hier, sondern unter `https://developer.szenera.com`: die Referenz jeder einzelnen Route, die vollständige Liste der Fehlercodes mit der erwarteten Reaktion, Idempotenz, das Prüfen der Signaturen, die Befehle der Kommandozeile, das Apps-SDK, die Werkzeuge für Assistenten und die Änderungen je Fassung.

## Was daraus folgt

Prüfen Sie zuerst das Recht und das Paket, dann stellen Sie den Schlüssel aus. Ein Schlüssel, den Sie ohne die nötigen Rechte anlegen, ist kein kleinerer Schlüssel, sondern einer, der beim ersten Aufruf abgewiesen wird.

Und geben Sie jedem Schlüssel nur, was sein Zweck braucht. Ein Import, der Medien hochlädt, muss keine Zeitpläne ändern dürfen — die sechs Klassen im Erstellen-Dialog sind genau dafür da.

## Weiterführendes

- [Einen API-Schlüssel erzeugen, rotieren und widerrufen](/de/docs/developers/create-api-key)
- [Webhooks einrichten und Zustellungen prüfen](/de/docs/developers/set-up-webhooks)
- [Die Kommandozeile szenera](/de/docs/developers/command-line)
- [Verbundene Anwendungen erlauben und widerrufen](/de/docs/organization/connected-applications)
- [Konten aus dem Personalverzeichnis (SCIM)](/de/docs/organization/scim-provisioning)