Ferndesk

Artikelübersetzungen

Fehlende Übersetzungen von Artikeln auflisten

Gibt für jedes angeforderte Gebietsschema die IDs veröffentlichter Artikel zurück, für die noch kein übersetzter Datensatz vorhanden ist. Standardmäßig werden alle aktivierten Übersetzungssprachen verwendet. Erfordert den Scope content:read.

Erforderlicher Scope: content:read

GET /articles/translations/missing

Fehlende Übersetzungen von Artikeln auflisten

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

Fehlende Übersetzungen

Authorizations

  • Authorization string erforderlich header

    Alle Anfragen erfordern ein Bearer-Token im Authorization-Header. API-Schlüssel beginnen mit fdsk_ und sollten geheim gehalten werden. Sie können Schlüssel über die 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: Hilfezentrumsartikel, 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, deren Veröffentlichung aufheben, wiederherstellen und in den Papierkorb verschieben (Änderungen live schalten)
    • analytics:read: Berichte, Analysen und Artikel-Feedback des Hilfezentrums 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 beinhaltet content:read. Vor der Einführung der Scoping-Funktion erstellte Schlüssel haben null Scopes = vollständiger Zugriff (Legacy-Modus).

Query Parameters

  • locales string

    Durch Kommas getrennter Gebietsschemafilter. Standardmäßig werden alle aktivierten Übersetzungssprachen verwendet. Beispiel: fr,es

Response

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