REST-Schnittstellen
Alles, was die Verwaltung der PurePower Engine kann, ist auch eine REST-Schnittstelle: Seiten, Formulare, Pipelines, Benutzer — und jede Funktion der installierten Plugins. Die Oberfläche selbst ruft dieselben Routen auf. Wer eine Anlage an ein anderes System anbindet, ein Dashboard baut oder eine App schreibt, nutzt also keinen Nebeneingang, sondern den Hauptweg — mit denselben Rechten und Prüfungen.
Zwei Bereiche, eine Rechteprüfung
/admin/api/v1/…— die Verwaltung und die Plugins, etwa/admin/api/v1/reservierung/buchungen. Im Browser mit der Sitzung und einem CSRF-Token, von aussen mit einem API-Schlüssel./api/v1/…— Schnittstellen für Programme: Formulare und Einreichungen, Abgleich, Plugin-Verwaltung, der MCP-Server. Nur mit Bearer-Token, ohne Sitzung.- Jede Route nennt das Recht, das sie verlangt (
permission='reservierung:lesen'). Geprüft wird für jeden Aufruf gleich, ob er aus dem Browser, über einen Schlüssel, aus einer Pipeline oder von einem KI-Assistenten kommt. - Antworten sind JSON. Eine Ratenbremse begrenzt die Aufrufe; die verbleibende Menge steht in den Kopfzeilen
X-RateLimit-LimitundX-RateLimit-Remaining.
curl -H "Authorization: Bearer pp_live_…" \
"https://anlage.example.ch/admin/api/v1/reservierung/ressourcen?art=raum"
{"gesamt": 3, "ressourcen": [{"id": 1, "name": "Sitzungszimmer Säntis", …}]}
API-Schlüssel und Scopes
Für jede Anbindung ein eigener, benannter Schlüssel — so lässt sich eine Integration abschalten, ohne die anderen zu berühren.
- Gespeichert wird nur ein Hash. Den Schlüssel selbst sieht man genau einmal, beim Anlegen.
- Scopes legen fest, was ein Schlüssel darf:
tickets:read,reservierung:writeoder mit Platzhalterwiki:*. Ein Schlüssel ohne Scopes darf nichts. - Nie mehr als das Konto: Ein Schlüssel gehört einem Benutzer, und dessen Rechte gelten weiter. Ein Schlüssel mit
tickets:readkann nicht schreiben, auch wenn sein Benutzer es könnte. Dienstkonten ohne Benutzer gibt es für Hintergrunddienste; dort sind die Scopes die einzige Schranke. - Lebenszyklus: Ablaufdatum, Scopes nachträglich ändern, erneuern (neuer Schlüssel, alter ungültig), widerrufen. Zu jedem Schlüssel steht die letzte Nutzung, und jeder Aufruf mit Schlüssel landet im Audit-Protokoll.
- Selbstbedienung: Benutzer stellen sich im eigenen Profil Schlüssel aus — ohne Verwaltungs- und Vollzugriffs-Scopes.
- Fremde Token: Token eines angebundenen Anmeldedienstes (OIDC) werden auf festgelegte Scopes abgebildet und sind damit kein Generalschlüssel.

Beschriebene Routen statt separater Doku
Die Beschreibung einer Route steht nicht in einer separaten Datei, die veraltet, sondern direkt an der Route: Der Vertrag (<contract> in der routes.xml) nennt Zweck, Parameter mit Typ, Pflicht, Vorgabe und erlaubten Werten sowie die Felder der Antwort. Der Linter im PP-SDK prüft Verträge schon beim Bauen, die Anlage noch einmal beim Laden des Plugins — jede Beanstandung mit Plugin, Methode, Pfad und Grund.
Aus demselben Vertrag entstehen die Werkzeuge für KI-Assistenten und die Knoten im Pipeline-Editor. Eine Beschreibung, drei Verwendungen — und keine davon kann von der Route abweichen.

Webhooks und Ereignisse
Plugins verschicken nichts selbst nach aussen. Sie melden Ereignisse — Buchung bestätigt, Ticket angelegt —, und Pipelines entscheiden, was daraus folgt. So entsteht ein Webhook ohne eine Zeile Code:
- Der Knoten Webhook Out schickt die Daten des Laufs als JSON per POST an eine Adresse; Status und Antwort stehen danach im Lauf.
- Ein Schutz gegen Anfragen ins eigene Netz sperrt interne, Loopback- und Metadaten-Adressen.
- Pipelines starten auf ein Ereignis, nach Zeitplan oder von Hand; jeder Lauf ist mit Knoten, Dauer und Fehler nachvollziehbar.
Abgleich für Offline-Apps
Für Apps, die unterwegs ohne Netz arbeiten, gibt es einen Abgleich der Formular-Einreichungen: GET /api/v1/sync/submissions?since=… holt nur, was sich seit dem letzten Stand geändert hat, POST /api/v1/sync/submissions schickt gesammelte Änderungen in einem Zug zurück. Wurde ein Eintrag inzwischen auf dem Server geändert, meldet die Antwort einen Konflikt, statt still zu überschreiben.
Zurück zur PurePower Engine.
Fragen zu REST-Schnittstellen?
Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.