Aller au contenu
FR

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 :

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}'

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.