Commentaires
Les commentaires s’attachent à un repère, une couche ou un dessin, avec un point géographique facultatif. L’API REST reflète les opérations disponibles dans l’application.
| Méthode | Chemin | Permission | Corps |
|---|---|---|---|
GET |
/api/rooms/:roomId/comments |
read | requête : 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 vaut marker, layer ou drawing. Exemple :
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}'Validation (400) : objectType doit être l’une des trois valeurs ; body non vide et ≤ 5000
caractères ; objectName ≤ 500 ; lat/lng finis, dans les bornes, les deux ou aucun.
Règles de suppression : un jeton d’API de salle ne peut supprimer que les commentaires et réponses dont il est l’auteur ; une session utilisateur peut tout supprimer.

