Documentation → Feedback
Documentation

Feedback

POST /feedback is the only endpoint that writes without a key — it backs the forms on these pages. Reading requires a key.

GET /feedback

Feedback Lesen

Submissions received, newest first. Requires authentication.

NameTypeMeaning
featurestring, in query
optional
kindstring, in query
optional
statusstring, in query
optional
limitinteger, in query
optional · default 50

Example

curl "$API/feedback" \
  -H "X-API-Key: $KEY"
POST /feedbackno key

Feedback Abgeben

Submit feedback or a question about a feature.

Always answers 202 as long as the format is valid — including when the submission is discarded as automated. A bot should not learn what gave it away, and a human gets the same friendly confirmation either way.

No parameters.

Request body FeedbackIn

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

Example

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

Submissions per feature and type — for prioritisation.

No parameters.

Example

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