Ferndesk

Analytique

Obtenir les analytiques des retours

Indicateurs clés d’utilité et synthèse des retours récents. Pour une ressource de retours paginée et exploitable pour le triage, utilisez /feedback. Les métriques sont calculées à partir du pipeline d’analytique et peuvent être égales à zéro lors d’une interruption du pipeline plutôt que de générer une erreur. Nécessite le scope analytics:read.

Scope requis : analytics:read

GET /analytics/feedback

Obtenir les analytiques des retours

curl --request GET \
  --url 'https://api.ferndesk.com/v1/analytics/feedback' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "key": "<string>"
}

Charge utile d’analytique

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 du développeur.

    Les clés peuvent être limitées à un sous-ensemble quelconque de ces scopes (chaque endpoint indique le scope requis 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 (appliquer les modifications)
    • analytics:read : Lire les rapports, les analytiques et les retours 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

    L’attribution de content:write ou content:publish implique content:read. Les clés générées avant la mise en place des scopes ont des scopes null = accès complet (mode hérité).

Query Parameters

  • end_date string

    Limite supérieure de date au format ISO.

  • start_date string

    Limite inférieure de date au format ISO.

Response

application/json
  • [key: string] any additional