Tellstack

REST-API

Ein Endpunkt für die Aufnahme von Feedback. Authentifizierung über den öffentlichen Projektschlüssel, der ausschließlich schreiben darf.

Anfrage

POST /api/v1/feedback Content-Type: application/json X-Tellstack-Key: ts_live_… { "message": "Der PDF-Export klemmt bei großen Dateien", "category": "bug", "email": "anna@example.com", "userId": "usr_123", "metadata": { "url": "https://app.example.com/export", "appVersion": "1.4.2", "platform": "ios", "device": "iPhone 15", "locale": "de-AT", "custom": { "plan": "pro" } } }

Der Schlüssel darf auch als Authorization: Bearer … oder als Query-Parameter ?key= kommen.

Felder

message
Pflicht. 2 bis 5.000 Zeichen. Bleibt unverändert gespeichert.
category
Optional. bug, idea, question oder other.
email
Optional. Ermöglicht eine Antwort per E-Mail.
userId
Optional. Deine eigene Nutzerkennung, max. 80 Zeichen.
metadata
Optional. url, appVersion, platform, device, locale und custom.

Antworten

HTTP/1.1 201 Created { "id": "…", "status": "new", "createdAt": "2026-08-19T09:12:44.101Z" }HTTP/1.1 400 Bad Request { "error": { "code": "validation_error", "message": "Eingabe ist ungueltig.", "details": { "issues": [{ "path": "message", "message": "Nachricht ist zu kurz." }] } } }
201
Angenommen.
400
validation_error — Feld fehlt oder ist unzulässig.
401
unauthorized — Schlüssel fehlt oder ist ungültig.
403
forbidden — Monatskontingent erschöpft oder Workspace gesperrt.
413
payload_too_large — mehr als 64 KB.
429
rate_limited — mehr als 120 Anfragen pro Minute je Schlüssel.

Gehostete Formulare

GET /api/v1/forms/:slug Konfiguration des Formulars POST /api/v1/forms/:slug/submit Einsendung

Diese Endpunkte brauchen keinen Schlüssel — der Slug genügt. Sie sind für eigene Oberflächen gedacht, die dieselbe Konfiguration nutzen wollen wie die gehostete Seite.

Was der Schlüssel nicht kann

Lesen. Es gibt keinen Weg, mit einem Projektschlüssel Feedback abzurufen, Projekte zu sehen oder Einstellungen zu ändern. Alles Lesende hängt an einer angemeldeten Sitzung und ist auf den Workspace begrenzt.

Schlüssel holen