REST-API
Ein versionierter Endpunkt unter /v1. Umfragen auflisten, anlegen und ändern, QR-Codes abrufen, Antworten und Statistiken lesen und Insights erzeugen — mit JSON, Bearer-Token und den üblichen HTTP-Statuscodes.
Entwickler
Simple Feedback hat eine öffentliche REST-API und einen MCP-Server. Beide arbeiten auf denselben Operationen: Umfragen anlegen und ändern, Antworten und Statistiken lesen, KI-Insights erzeugen — aus deiner eigenen Anwendung heraus oder direkt aus deiner eigenen KI.
MCP-Server
Derselbe Funktionsumfang als Model-Context-Protocol-Server. Du richtest deinen eigenen KI-Client darauf und deine KI arbeitet direkt mit deinen Umfragen und Antworten — ohne dass du eine Integration dafür schreiben musst.
Beide Oberflächen laufen über dieselbe Operationsschicht. Was die REST-API kann, kann auch der MCP-Server, und beide prüfen dieselben Berechtigungen.
API-Zugriff ist ein Tarif-Feature
Der Zugriff auf REST-API und MCP-Server ist ausschließlich in zwei Tarifen enthalten. In allen anderen Tarifen lässt sich kein Schlüssel ausstellen, und ein bestehender Schlüssel wird nach einem Wechsel bei jeder Anfrage abgelehnt.
- Free Kein API-Zugriff
- Basic Kein API-Zugriff
- Premium Kein API-Zugriff
- Business API-Zugriff enthalten
- Individual API-Zugriff enthalten
Einen Schlüssel bekommen
Erstelle ihn selbst im Dashboard unter Einstellungen → API-Schlüssel. Inhaber:innen und Admins der Organisation können dort Schlüssel anlegen, einsehen und widerrufen — in jedem Tarif, der API-Zugriff enthält. Enthält dein Tarif ihn noch nicht, oder möchtest du den ersten Schlüssel lieber gemeinsam mit uns einrichten, schreib uns, für welche Organisation du einen Schlüssel brauchst und welche Scopes er tragen soll.
Der Schlüssel beginnt mit sfk_ und wird genau einmal angezeigt. Gespeichert wird nur sein Hash — ein verlorener Schlüssel wird ersetzt, nicht wiederhergestellt.
Scopes
Jeder Schlüssel trägt eine feste Liste von Scopes, die beim Ausstellen festgelegt wird. Fehlt der passende Scope, antwortet die API mit einem Fehler statt mit Daten.
surveys:readUmfragen und ihre Konfiguration lesen.surveys:writeUmfragen anlegen und ändern.responses:readEingegangene Antworten und Statistiken lesen.insights:readBereits erzeugte KI-Insights lesen.insights:writeNeue KI-Insights zu einer Umfrage erzeugen.qr:readGespeicherte QR-Codes und ihre Scan-Statistik lesen.qr:writeGespeicherte QR-Codes anlegen, auf eine andere Umfrage umstellen, abschalten und löschen.access-codes:readDen Status der Einmal-Codes einer Umfrage lesen und den Link oder QR-Code zu einem bekannten Code erzeugen. Die Codes selbst gibt die API nie wieder heraus.access-codes:writeEinmal-Codes für eine Umfrage erstellen und unbenutzte widerrufen. Der Code steht nur in der Antwort auf das Erstellen.files:writeEin Logo oder Hintergrundbild für Umfragen hochladen. Es zählt zum Speicherplatz des Tarifs.
Ein :write-Scope schließt den passenden :read-Scope nicht ein. Ein Schlüssel, der beides braucht, trägt beides — so kann eine Integration, die nur Umfragen anlegt, die gesammelten Antworten nicht mitlesen.
Der erste Aufruf
Der Schlüssel geht als Bearer-Token im Authorization-Header mit. Ob er funktioniert, klärt ein einziger Aufruf:
curl -H "Authorization: Bearer sfk_..." \
https://simplefeedback.de/api/v1/meDie Antwort nennt Organisation, Tarif, Scopes und das Präfix des Schlüssels. Dieser Endpunkt braucht selbst keinen Scope — wer den Schlüssel hat, darf erfahren, was er kann.
Pro Schlüssel gelten standardmäßig 60 Anfragen pro Minute; einzelne Endpunkte erlauben mehr — das Erzeugen von KI-Auswertungen deutlich weniger: 2 pro Minute, denn ein einziger Aufruf wertet alle Antworten der Umfrage aus.
Deine eigene KI anbinden
Richte einen MCP-fähigen KI-Client auf diesen Endpunkt. Clients wie Claude und Claude Code brauchen nur die Adresse: Beim ersten Verbinden meldest du dich bei Simple Feedback an und gibst die Rechte frei. Kann dein Client das nicht, gib einen API-Schlüssel als Bearer-Token mit.
POST https://simplefeedback.de/api/mcpDie Werkzeugliste, die dein Client zu sehen bekommt, ist nach den Scopes des Schlüssels gefiltert: Ein Schlüssel ohne surveys:write sieht kein Werkzeug, mit dem sich eine Umfrage ändern ließe.
Dokumentation
Die vollständige Referenz aller Endpunkte, Parameter und Antwortformate wird direkt von der API ausgeliefert. Das rohe OpenAPI-Dokument eignet sich als Eingabe für Client-Generatoren.