Ferndesk

Traductions d’articles

Lister les traductions de l’article

Renvoie l’état de traduction d’un article dans toutes les langues, y compris les traductions obsolètes. Nécessite la portée content:read.

Portée requise : content:read

GET /articles/{id}/translations

Lister les traductions de l’article

curl --request GET \
  --url 'https://api.ferndesk.com/v1/articles/{ID}/translations' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
  {
    "language": "<string>",
    "status": "<string>",
    "isManual": true,
    "sourceArticleVersion": 1,
    "stale": true,
    "updatedAt": "<string>"
  }
]

Traductions

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 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 créées avant la mise en place des portées ont des portées nulles = accès complet (mode hérité).

Path Parameters

  • id string requis

    ID de ressource de l’entité demandée. Exemple: art_01JXY9AZK4KV

Response

application/json
  • items[] object array item

    Résumé de l’état des traductions.

    + Show Child Attributes
    • language string
    • status string
    • isManual boolean
    • sourceArticleVersion integer | null
    • stale boolean

      Indique si l’article source a été modifié depuis cette traduction.

    • updatedAt string | null