Dokumentation → Feedback
Dokumentation

Feedback

POST /feedback ist der einzige Endpunkt, der ohne Schlüssel schreibt — er versorgt die Formulare auf diesen Seiten. Gelesen wird nur mit Schlüssel.

GET /feedback

Feedback Lesen

Eingegangene Zuschriften, neueste zuerst. Verlangt Anmeldung.

NameTypBedeutung
featurestring, in der Abfrage
optional
kindstring, in der Abfrage
optional
statusstring, in der Abfrage
optional
limitinteger, in der Abfrage
optional · Vorgabe 50

Beispiel

curl "$API/feedback" \
  -H "X-API-Key: $KEY"
POST /feedbackohne Schlüssel

Feedback Abgeben

Feedback oder eine Rueckfrage zu einem Feature abgeben.

Antwortet immer mit 202, sofern das Format stimmt — auch wenn die Zuschrift als automatisiert verworfen wird. Ein Bot soll nicht erfahren, woran er gescheitert ist, und ein Mensch bekommt in beiden Faellen dieselbe freundliche Bestaetigung.

Keine Parameter.

Anfragekörper FeedbackIn

NameTypBedeutung
featurestring
Pflicht
Feature-Kennung, z. B. 'fundamentaldaten'
kindstring
optional · Vorgabe feedback
Kind
messagestring
Pflicht
Message
emailstring
optional
optional, nur fuer Rueckfragen
pagestring
optional
URL, von der abgeschickt wurde
langstring
optional
Lang
websitestring
optional
Website

Beispiel

curl -X POST "$API/feedback" \
  -H "Content-Type: application/json" \
  -d '{ "feature": "fundamentaldaten", "kind": "question",
        "message": "Gilt die Datumskorrektur auch für Quartale?" }'
HTTP/1.1 202 Accepted

{ "accepted": true }
GET /feedback/stats

Feedback Stats

Zuschriften je Feature und Art — fuer die Priorisierung.

Keine Parameter.

Beispiel

curl "$API/feedback/stats" \
  -H "X-API-Key: $KEY"