Ferndesk

Traductions des articles

Répertorier les langues du centre d’aide

Retourne la langue par défaut et toutes les langues de traduction configurées pour votre centre d’aide. Nécessite le scope content:read.

Scope requis : content:read

GET /articles/languages

Répertorier les langues du centre d’aide

curl --request GET \
  --url 'https://api.ferndesk.com/v1/articles/languages' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "default": "<string>",
  "languages": [
    {
      "language": "<string>",
      "displayName": "<string>",
      "isDefault": true,
      "isEnabled": true
    }
  ]
}

Langues

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 des scopes suivants (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 les brouillons d’articles, les utilisateurs et les tâches ; déplacer les articles et les collections
    • content:publish : Publier, dépublier, restaurer et mettre à la corbeille du contenu (rendre les modifications effectives)
    • analytics:read : Lire les rapports, analyses et 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

    Accorder content:write ou content:publish implique content:read. Les clés créées avant la mise en place des scopes ont des scopes null = accès complet (mode hérité).

Response

application/json
  • default string
  • languages[] object array
    + Show Child Attributes
    • language string
    • displayName string
    • isDefault boolean
    • isEnabled boolean