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 | — |
Réservé aux membres. Les commentaires appartiennent aux membres de la salle, y compris dans les
salles publiques. Pour les lister, il faut un jeton d’API de salle avec read ou la session d’un membre
(propriétaire, éditeur ou lecteur). Sans identifiants, l’API répond 401 ; un utilisateur connecté qui
n’est pas membre reçoit 403.
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.