Zum Inhalt springen
DE

Kommentare

Kommentare hängen an einem Marker, einer Ebene oder einer Zeichnung, mit optionaler geografischer Verankerung. REST bildet die Vorgänge in der App ab.

Methode Pfad Berechtigung Rumpf
GET /api/rooms/:roomId/comments read Query: objectId?, objectType?, resolved?
POST /api/rooms/:roomId/comments write { objectId, objectType, body, objectName?, lat?, lng? }
POST /api/rooms/:roomId/comments/:commentId/replies write { body }
PATCH /api/rooms/:roomId/comments/:commentId write { resolved: boolean }
DELETE /api/rooms/:roomId/comments/:commentId write —
DELETE /api/rooms/:roomId/comments/:commentId/replies/:replyId write —

Nur für Mitglieder. Kommentare gehören den Mitgliedern des Raums, auch in öffentlichen Räumen. Zum Auflisten braucht es ein Raum-API-Token mit read oder die Sitzung eines Mitglieds (Eigentümer, Bearbeiter oder Betrachter). Ohne Anmeldedaten antwortet die API mit 401; angemeldete Nutzer, die nicht Mitglied sind, erhalten 403.

objectType ist eines von marker, layer, drawing. Beispiel:

Terminal window
curl -X POST "$API/api/rooms/$ROOM/comments" -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"objectId":"marker-1","objectType":"marker","body":"needs review","lat":47.56,"lng":7.59}'

Validierung (400): objectType muss eines der drei sein; body nicht leer und ≤ 5000 Zeichen; objectName ≤ 500; lat/lng endlich, im gültigen Bereich, beide oder keines.

Löschregeln: Ein Raum-API-Token darf nur Kommentare/Antworten löschen, die es selbst verfasst hat; eine Benutzersitzung darf alle löschen.