Commentaires

Gérer les commentaires et réponses sur les fiches

Récupérer les commentaires de plusieurs fiches

post

Retourne les commentaires pour jusqu'à 1000 identifiants de fiches en une seule requête.

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

Corps

application/json

submission_idsstring · uuid[] · max: 1000Requis

Liste des UUIDs de fiches dont récupérer les commentaires

Réponses

200

Commentaires groupés par UUID de fiche

application/json

400

Trop d'identifiants de fiches — max 1000 (DAERR-COM1010)

application/json

post/{app_short}/submissions/comments

HTTPcURLJavaScriptPython

POST /{app_short}/submissions/comments HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "submission_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "ANY_ADDITIONAL_PROPERTY": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "message": "text",
      "client_created_at": 1,
      "client_updated_at": 1,
      "user_id": 1,
      "submission_id": "123e4567-e89b-12d3-a456-426614174000",
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "message": "text",
          "client_created_at": 1,
          "client_updated_at": 1,
          "user_id": 1,
          "submission_id": "123e4567-e89b-12d3-a456-426614174000",
          "replies": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}

Compter les commentaires d'une fiche

get

Retourne le nombre total de commentaires liés à une fiche.

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

idstring · uuidRequis

Identifiant de la fiche (UUID)

Réponses

200

Nombre total de commentaires

application/json

countintegerOptionnel

Nombre total de commentaires liés à la fiche

get/{app_short}/submissions/{id}/comments/count

HTTPcURLJavaScriptPython

GET /{app_short}/submissions/{id}/comments/count HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Nombre total de commentaires

{
  "count": 1
}

Lister les commentaires d'une fiche

get

Retourne tous les commentaires (et leurs réponses) de la fiche indiquée.

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

idstring · uuidRequis

Identifiant de la fiche (UUID)

Réponses

200

Liste des commentaires (réponses incluses)

application/json

Commentaire sur une fiche

idstring · uuidOptionnel

Identifiant du commentaire (UUID v4)

messagestring · max: 1000Optionnel

Texte brut uniquement — pas de HTML ni de balises script

client_created_atinteger · int64Optionnel

Date de création côté client (timestamp UNIX)

client_updated_atinteger · int64Optionnel

Date de mise à jour côté client (timestamp UNIX)

user_idintegerOptionnel

Identifiant de l'auteur

submission_idstring · uuidOptionnel

Identifiant de la fiche associée

403

Accès à la fiche interdit (DAERR-COM1000)

application/json

404

Fiche introuvable (DAERR-COM1006)

application/json

get/{app_short}/submissions/{id}/comments

HTTPcURLJavaScriptPython

GET /{app_short}/submissions/{id}/comments HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "message": "text",
    "client_created_at": 1,
    "client_updated_at": 1,
    "user_id": 1,
    "submission_id": "123e4567-e89b-12d3-a456-426614174000",
    "replies": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "message": "text",
        "client_created_at": 1,
        "client_updated_at": 1,
        "user_id": 1,
        "submission_id": "123e4567-e89b-12d3-a456-426614174000",
        "replies": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "message": "text",
            "client_created_at": 1,
            "client_updated_at": 1,
            "user_id": 1,
            "submission_id": "123e4567-e89b-12d3-a456-426614174000",
            "replies": "[Circular Reference]"
          }
        ]
      }
    ]
  }
]

Créer un commentaire sur une fiche

post

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.

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

idstring · uuidRequis

Identifiant de la fiche (UUID)

Corps

application/json

Corps d'une création ou mise à jour de commentaire

idstring · uuidOptionnel

UUID v4 optionnel fourni par le client

messagestring · max: 1000Requis

Texte brut uniquement — pas de HTML, balises script ou caractères dangereux

client_created_atinteger · int64Optionnel

Timestamp UNIX côté client

client_updated_atinteger · int64Optionnel

Timestamp UNIX côté client

Réponses

200

Commentaire créé

application/json

Commentaire sur une fiche

idstring · uuidOptionnel

Identifiant du commentaire (UUID v4)

messagestring · max: 1000Optionnel

Texte brut uniquement — pas de HTML ni de balises script

client_created_atinteger · int64Optionnel

Date de création côté client (timestamp UNIX)

client_updated_atinteger · int64Optionnel

Date de mise à jour côté client (timestamp UNIX)

user_idintegerOptionnel

Identifiant de l'auteur

submission_idstring · uuidOptionnel

Identifiant de la fiche associée

400

Erreur de validation — message manquant (DAERR-COM1002), trop long (DAERR-COM1003), date invalide (DAERR-COM1004), caractères invalides (DAERR-COM1005), UUID invalide (DAERR-COM1009), ou limite de commentaires atteinte (DAERR-COM1012)

application/json

403

Accès interdit (DAERR-COM1000)

application/json

post/{app_short}/submissions/{id}/comments

HTTPcURLJavaScriptPython

POST /{app_short}/submissions/{id}/comments HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "client_created_at": 1,
  "client_updated_at": 1
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "client_created_at": 1,
  "client_updated_at": 1,
  "user_id": 1,
  "submission_id": "123e4567-e89b-12d3-a456-426614174000",
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "message": "text",
      "client_created_at": 1,
      "client_updated_at": 1,
      "user_id": 1,
      "submission_id": "123e4567-e89b-12d3-a456-426614174000",
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "message": "text",
          "client_created_at": 1,
          "client_updated_at": 1,
          "user_id": 1,
          "submission_id": "123e4567-e89b-12d3-a456-426614174000",
          "replies": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}

Mettre à jour un commentaire

put

Modifie le texte d'un commentaire. Un utilisateur ne peut modifier que ses propres commentaires (DAERR-COM1008).

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

idstring · uuidRequis

Identifiant de la fiche (UUID)

comment_idstring · uuidRequis

Identifiant du commentaire (UUID)

Corps

application/json

Corps d'une création ou mise à jour de commentaire

idstring · uuidOptionnel

UUID v4 optionnel fourni par le client

messagestring · max: 1000Requis

Texte brut uniquement — pas de HTML, balises script ou caractères dangereux

client_created_atinteger · int64Optionnel

Timestamp UNIX côté client

client_updated_atinteger · int64Optionnel

Timestamp UNIX côté client

Réponses

200

Commentaire mis à jour

application/json

Commentaire sur une fiche

idstring · uuidOptionnel

Identifiant du commentaire (UUID v4)

messagestring · max: 1000Optionnel

Texte brut uniquement — pas de HTML ni de balises script

client_created_atinteger · int64Optionnel

Date de création côté client (timestamp UNIX)

client_updated_atinteger · int64Optionnel

Date de mise à jour côté client (timestamp UNIX)

user_idintegerOptionnel

Identifiant de l'auteur

submission_idstring · uuidOptionnel

Identifiant de la fiche associée

403

Modification non autorisée (DAERR-COM1008)

application/json

404

Commentaire introuvable (DAERR-COM1001)

application/json

put/{app_short}/submissions/{id}/comments/{comment_id}

HTTPcURLJavaScriptPython

PUT /{app_short}/submissions/{id}/comments/{comment_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "client_created_at": 1,
  "client_updated_at": 1
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "client_created_at": 1,
  "client_updated_at": 1,
  "user_id": 1,
  "submission_id": "123e4567-e89b-12d3-a456-426614174000",
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "message": "text",
      "client_created_at": 1,
      "client_updated_at": 1,
      "user_id": 1,
      "submission_id": "123e4567-e89b-12d3-a456-426614174000",
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "message": "text",
          "client_created_at": 1,
          "client_updated_at": 1,
          "user_id": 1,
          "submission_id": "123e4567-e89b-12d3-a456-426614174000",
          "replies": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}

Supprimer un commentaire

delete

Supprime un commentaire. Un utilisateur ne peut supprimer que ses propres commentaires (DAERR-COM1007).

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

idstring · uuidRequis

Identifiant de la fiche (UUID)

comment_idstring · uuidRequis

Identifiant du commentaire (UUID)

Réponses

204

Commentaire supprimé

Aucun contenu

403

Suppression non autorisée (DAERR-COM1007)

application/json

404

Commentaire introuvable (DAERR-COM1001)

application/json

delete/{app_short}/submissions/{id}/comments/{comment_id}

HTTPcURLJavaScriptPython

DELETE /{app_short}/submissions/{id}/comments/{comment_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

Aucun contenu

Répondre à un commentaire

post

Ajoute une réponse à un commentaire de premier niveau (profondeur maximale : 2). Répondre à une réponse n'est pas autorisé (DAERR-COM1011).

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

idstring · uuidRequis

Identifiant de la fiche (UUID)

comment_idstring · uuidRequis

Identifiant du commentaire parent (UUID)

Corps

application/json

Corps d'une création ou mise à jour de commentaire

idstring · uuidOptionnel

UUID v4 optionnel fourni par le client

messagestring · max: 1000Requis

Texte brut uniquement — pas de HTML, balises script ou caractères dangereux

client_created_atinteger · int64Optionnel

Timestamp UNIX côté client

client_updated_atinteger · int64Optionnel

Timestamp UNIX côté client

Réponses

200

Réponse créée

application/json

Commentaire sur une fiche

idstring · uuidOptionnel

Identifiant du commentaire (UUID v4)

messagestring · max: 1000Optionnel

Texte brut uniquement — pas de HTML ni de balises script

client_created_atinteger · int64Optionnel

Date de création côté client (timestamp UNIX)

client_updated_atinteger · int64Optionnel

Date de mise à jour côté client (timestamp UNIX)

user_idintegerOptionnel

Identifiant de l'auteur

submission_idstring · uuidOptionnel

Identifiant de la fiche associée

403

Impossible de répondre à un commentaire de second niveau (DAERR-COM1011)

application/json

post/{app_short}/submissions/{id}/comments/{comment_id}/replies

HTTPcURLJavaScriptPython

POST /{app_short}/submissions/{id}/comments/{comment_id}/replies HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "client_created_at": 1,
  "client_updated_at": 1
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "client_created_at": 1,
  "client_updated_at": 1,
  "user_id": 1,
  "submission_id": "123e4567-e89b-12d3-a456-426614174000",
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "message": "text",
      "client_created_at": 1,
      "client_updated_at": 1,
      "user_id": 1,
      "submission_id": "123e4567-e89b-12d3-a456-426614174000",
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "message": "text",
          "client_created_at": 1,
          "client_updated_at": 1,
          "user_id": 1,
          "submission_id": "123e4567-e89b-12d3-a456-426614174000",
          "replies": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}