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 | — |
objectType ist eines von marker, layer, drawing. Beispiel:
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.

