Ferndesk

Commentaires

Obtenir les commentaires

Renvoie une entrée de commentaire unique. Nécessite la portée analytics:read.

Portée requise : analytics:read

GET /feedback/{id}

Obtenir les commentaires

curl --request GET \
  --url 'https://api.ferndesk.com/v1/feedback/{ID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "<string>",
  "articleId": "<string>",
  "articleTitle": "<string>",
  "type": "positive",
  "feedback": "<string>",
  "email": "<string>",
  "resolved": true,
  "createdAt": "<string>",
  "user": {
    "id": "<string>",
    "name": "<string>",
    "email": "<email>"
  }
}

Commentaires

Authorizations

  • Authorization string requis header

    Toutes les requêtes nécessitent un jeton Bearer dans l’en-tête Authorization. Les clés API sont préfixées par fdsk_ et doivent rester secrètes. Vous pouvez générer et gérer les clés depuis la page Paramètres développeur.

    Les clés peuvent être limitées à n’importe quel sous-ensemble de ces portées (chaque endpoint indique la portée requise via x-required-scopes) :

    • content:read : Lire et rechercher les articles, collections, sections et traductions du centre d’aide
    • content:write : Créer et modifier des brouillons d’articles, des utilisateurs et des tâches ; déplacer des articles et des collections
    • content:publish : Publier, dépublier, restaurer et mettre à la corbeille du contenu (rendre les modifications visibles)
    • analytics:read : Lire les rapports, analyses et commentaires sur les articles du centre d’aide
    • conversations:read : Lire les conversations et transcriptions de l’assistant IA
    • webhooks:manage : Créer et gérer les abonnements aux webhooks sortants

    Accorder content:write ou content:publish implique content:read. Les clés créées avant la mise en place des portées ont des portées nulles, ce qui accorde un accès complet (mode legacy).

Path Parameters

  • id string requis

Response

application/json
  • id string
  • articleId string | null
  • articleTitle string | null
  • type string enum enum

    Allowed values: positive, negative.

  • feedback string
  • email string | null
  • resolved boolean
  • createdAt string

    Horodatage ISO 8601 en UTC.

  • user anyOf

    Utilisateur du centre d’aide automatiquement associé à partir de l’adresse e-mail de l’expéditeur (unique pour une combinaison e-mail + helpdesk), ou null lorsque l’expéditeur est anonyme ou non reconnu.

    + Show Child Attributes
    • anyOf options 2 variants anyOf

      One or more options can apply.

      + Show Child Attributes
      • option 1 object
        + Show Child Attributes
        • id string

          ID utilisateur du centre d’aide Ferndesk (hcusr_...).

        • name string | null

          Nom d’affichage de l’utilisateur du centre d’aide.

        • email string (email)

          Adresse e-mail de l’utilisateur du centre d’aide. Les adresses e-mail sont stockées en minuscules.

      • option 2 null