# Commentaires
## Récupérer les commentaires de plusieurs fiches
> Retourne les commentaires pour jusqu'à \*\*1000\*\* identifiants de fiches en une seule requête.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"Comment":{"type":"object","description":"Commentaire sur une fiche","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant du commentaire (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML ni de balises script"},"client_created_at":{"type":"integer","format":"int64","description":"Date de création côté client (timestamp UNIX)"},"client_updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour côté client (timestamp UNIX)"},"user_id":{"type":"integer","description":"Identifiant de l'auteur"},"submission_id":{"type":"string","format":"uuid","description":"Identifiant de la fiche associée"},"replies":{"type":"array","description":"Réponses de second niveau (profondeur maximale : 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/submissions/comments":{"post":{"summary":"Récupérer les commentaires de plusieurs fiches","description":"Retourne les commentaires pour jusqu'à **1000** identifiants de fiches en une seule requête.","tags":["submission-comments"],"operationId":"getCommentsBySubmissionIds","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["submission_ids"],"properties":{"submission_ids":{"type":"array","maxItems":1000,"description":"Liste des UUIDs de fiches dont récupérer les commentaires","items":{"type":"string","format":"uuid"}}}}}}},"responses":{"200":{"description":"Commentaires groupés par UUID de fiche","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/Comment"}}}}}},"400":{"description":"Trop d'identifiants de fiches — max 1000 (DAERR-COM1010)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Lister les commentaires d'une fiche
> Retourne tous les commentaires (et leurs réponses) de la fiche indiquée.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"Comment":{"type":"object","description":"Commentaire sur une fiche","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant du commentaire (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML ni de balises script"},"client_created_at":{"type":"integer","format":"int64","description":"Date de création côté client (timestamp UNIX)"},"client_updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour côté client (timestamp UNIX)"},"user_id":{"type":"integer","description":"Identifiant de l'auteur"},"submission_id":{"type":"string","format":"uuid","description":"Identifiant de la fiche associée"},"replies":{"type":"array","description":"Réponses de second niveau (profondeur maximale : 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/submissions/{id}/comments":{"get":{"summary":"Lister les commentaires d'une fiche","description":"Retourne tous les commentaires (et leurs réponses) de la fiche indiquée.","tags":["submission-comments"],"operationId":"listSubmissionComments","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Identifiant de la fiche (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Liste des commentaires (réponses incluses)","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Comment"}}}}},"403":{"description":"Accès à la fiche interdit (DAERR-COM1000)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Fiche introuvable (DAERR-COM1006)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Créer un commentaire sur une fiche
> Ajoute un nouveau commentaire. Texte brut uniquement — pas de HTML ni de balises script.\
> Maximum \*\*1000 caractères\*\*. Accepte un UUID optionnel fourni par le client.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"CommentInput":{"type":"object","required":["message"],"description":"Corps d'une création ou mise à jour de commentaire","properties":{"id":{"type":"string","format":"uuid","description":"UUID v4 optionnel fourni par le client"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML, balises script ou caractères dangereux"},"client_created_at":{"type":"integer","format":"int64","description":"Timestamp UNIX côté client"},"client_updated_at":{"type":"integer","format":"int64","description":"Timestamp UNIX côté client"}}},"Comment":{"type":"object","description":"Commentaire sur une fiche","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant du commentaire (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML ni de balises script"},"client_created_at":{"type":"integer","format":"int64","description":"Date de création côté client (timestamp UNIX)"},"client_updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour côté client (timestamp UNIX)"},"user_id":{"type":"integer","description":"Identifiant de l'auteur"},"submission_id":{"type":"string","format":"uuid","description":"Identifiant de la fiche associée"},"replies":{"type":"array","description":"Réponses de second niveau (profondeur maximale : 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/submissions/{id}/comments":{"post":{"summary":"Créer un commentaire sur une fiche","description":"Ajoute un nouveau commentaire. Texte brut uniquement — pas de HTML ni de balises script.\nMaximum **1000 caractères**. Accepte un UUID optionnel fourni par le client.\n","tags":["submission-comments"],"operationId":"createSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Identifiant de la fiche (UUID)","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentInput"}}}},"responses":{"200":{"description":"Commentaire créé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"400":{"description":"Erreur de validation — message manquant (DAERR-COM1002), trop long\n(DAERR-COM1003), date invalide (DAERR-COM1004), caractères invalides\n(DAERR-COM1005), UUID invalide (DAERR-COM1009), ou limite de commentaires\natteinte (DAERR-COM1012)\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Accès interdit (DAERR-COM1000)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Mettre à jour un commentaire
> Modifie le texte d'un commentaire. Un utilisateur ne peut modifier\
> que ses propres commentaires (DAERR-COM1008).
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"CommentInput":{"type":"object","required":["message"],"description":"Corps d'une création ou mise à jour de commentaire","properties":{"id":{"type":"string","format":"uuid","description":"UUID v4 optionnel fourni par le client"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML, balises script ou caractères dangereux"},"client_created_at":{"type":"integer","format":"int64","description":"Timestamp UNIX côté client"},"client_updated_at":{"type":"integer","format":"int64","description":"Timestamp UNIX côté client"}}},"Comment":{"type":"object","description":"Commentaire sur une fiche","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant du commentaire (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML ni de balises script"},"client_created_at":{"type":"integer","format":"int64","description":"Date de création côté client (timestamp UNIX)"},"client_updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour côté client (timestamp UNIX)"},"user_id":{"type":"integer","description":"Identifiant de l'auteur"},"submission_id":{"type":"string","format":"uuid","description":"Identifiant de la fiche associée"},"replies":{"type":"array","description":"Réponses de second niveau (profondeur maximale : 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/submissions/{id}/comments/{comment_id}":{"put":{"summary":"Mettre à jour un commentaire","description":"Modifie le texte d'un commentaire. Un utilisateur ne peut modifier\nque ses propres commentaires (DAERR-COM1008).\n","tags":["submission-comments"],"operationId":"updateSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Identifiant de la fiche (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"comment_id","in":"path","required":true,"description":"Identifiant du commentaire (UUID)","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentInput"}}}},"responses":{"200":{"description":"Commentaire mis à jour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"403":{"description":"Modification non autorisée (DAERR-COM1008)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Commentaire introuvable (DAERR-COM1001)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Supprimer un commentaire
> Supprime un commentaire. Un utilisateur ne peut supprimer\
> que ses propres commentaires (DAERR-COM1007).
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/submissions/{id}/comments/{comment_id}":{"delete":{"summary":"Supprimer un commentaire","description":"Supprime un commentaire. Un utilisateur ne peut supprimer\nque ses propres commentaires (DAERR-COM1007).\n","tags":["submission-comments"],"operationId":"deleteSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Identifiant de la fiche (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"comment_id","in":"path","required":true,"description":"Identifiant du commentaire (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Commentaire supprimé"},"403":{"description":"Suppression non autorisée (DAERR-COM1007)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Commentaire introuvable (DAERR-COM1001)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Répondre à un commentaire
> Ajoute une réponse à un commentaire de premier niveau (profondeur maximale : 2).\
> Répondre à une réponse n'est pas autorisé (DAERR-COM1011).
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"CommentInput":{"type":"object","required":["message"],"description":"Corps d'une création ou mise à jour de commentaire","properties":{"id":{"type":"string","format":"uuid","description":"UUID v4 optionnel fourni par le client"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML, balises script ou caractères dangereux"},"client_created_at":{"type":"integer","format":"int64","description":"Timestamp UNIX côté client"},"client_updated_at":{"type":"integer","format":"int64","description":"Timestamp UNIX côté client"}}},"Comment":{"type":"object","description":"Commentaire sur une fiche","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant du commentaire (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Texte brut uniquement — pas de HTML ni de balises script"},"client_created_at":{"type":"integer","format":"int64","description":"Date de création côté client (timestamp UNIX)"},"client_updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour côté client (timestamp UNIX)"},"user_id":{"type":"integer","description":"Identifiant de l'auteur"},"submission_id":{"type":"string","format":"uuid","description":"Identifiant de la fiche associée"},"replies":{"type":"array","description":"Réponses de second niveau (profondeur maximale : 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/submissions/{id}/comments/{comment_id}/replies":{"post":{"summary":"Répondre à un commentaire","description":"Ajoute une réponse à un commentaire de premier niveau (profondeur maximale : 2).\nRépondre à une réponse n'est pas autorisé (DAERR-COM1011).\n","tags":["submission-comments"],"operationId":"replyToSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Identifiant de la fiche (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"comment_id","in":"path","required":true,"description":"Identifiant du commentaire parent (UUID)","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentInput"}}}},"responses":{"200":{"description":"Réponse créée","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"403":{"description":"Impossible de répondre à un commentaire de second niveau (DAERR-COM1011)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://www.center.daxium-air.com/api-reference/doc-api/fiches/commentaires.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.