Ferndesk

Traductions d’articles

Lister les articles auxquels il manque des traductions

Retourne, pour chaque langue demandée, les identifiants des articles publiés qui ne disposent pas encore d’une ligne traduite. Par défaut, utilise toutes les langues de traduction activées. Nécessite la portée content:read.

Portée requise : content:read

GET /articles/translations/missing

Lister les articles auxquels il manque des traductions

curl --request GET \
  --url 'https://api.ferndesk.com/v1/articles/translations/missing' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "missing": {
    "key": [
      "<string>"
    ]
  }
}

Traductions manquantes

Authorizations

  • Authorization string requis header

    Toutes les requêtes nécessitent un token 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 des 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 : Consulter les rapports, les analyses et les retours sur les articles du centre d’aide
    • conversations:read : Lire les conversations et les transcriptions de l’assistant IA
    • webhooks:manage : Créer et gérer des 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 null = accès complet (mode hérité).

Query Parameters

  • locales string

    Filtre de langues séparées par des virgules. Par défaut, utilise toutes les langues de traduction activées. Exemple: fr,es

Response

application/json
  • missing object
    + Show Child Attributes
    • [key: string] array additional
      + Show Child Attributes
      • items[] string array item