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.

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.

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.

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

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
• Webhooks einrichten und Zustellungen prüfen
• Die Kommandozeile szenera
• Verbundene Anwendungen erlauben und widerrufen
• Konten aus dem Personalverzeichnis (SCIM)