Ferndesk

Artikelübersetzungen

Artikelübersetzungen auflisten

Gibt den Übersetzungsstatus eines Artikels für alle Gebietsschemata einschließlich des Aktualitätsstatus zurück. Erfordert den Scope content:read.

Erforderlicher Scope: content:read

GET /articles/{id}/translations

Artikelübersetzungen auflisten

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>"
  }
]

Übersetzungen

Authorizations

  • Authorization string erforderlich header

    Alle Anfragen erfordern ein Bearer-Token im Authorization-Header. API-Schlüssel beginnen mit fdsk_ und müssen geheim gehalten werden. Sie können Schlüssel auf der Seite Entwicklereinstellungen erstellen und verwalten.

    Schlüssel können auf eine beliebige Teilmenge dieser Scopes beschränkt werden (jeder Endpunkt führt den erforderlichen Scope über x-required-scopes auf):

    • content:read: Hilfecenter-Artikel, Sammlungen, Abschnitte und Übersetzungen lesen und durchsuchen
    • content:write: Artikelentwürfe, Benutzer und Aufgaben erstellen und bearbeiten; Artikel und Sammlungen verschieben
    • content:publish: Inhalte veröffentlichen, ihre Veröffentlichung aufheben, wiederherstellen und löschen (Änderungen live schalten)
    • analytics:read: Berichte, Analysen und Artikel-Feedback des Hilfecenters lesen
    • conversations:read: Unterhaltungen und Transkripte des KI-Assistenten lesen
    • webhooks:manage: Ausgehende Webhook-Abonnements erstellen und verwalten

    Die Vergabe von content:write oder content:publish schließt content:read ein. Vor der Einführung von Scopes ausgestellte Schlüssel haben null Scopes = vollständigen Zugriff (Legacy-Modus).

Path Parameters

  • id string erforderlich

    Ressourcen-ID der angeforderten Entität. Beispiel: art_01JXY9AZK4KV

Response

application/json
  • items[] object array item

    Zusammenfassung des Übersetzungsstatus.

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

      Gibt an, ob der Quellartikel seit dieser Übersetzung geändert wurde.

    • updatedAt string | null