Ferndesk

Artikelrevisionen

Artikelrevisionen auflisten

Listet den Versionsverlauf eines Artikels auf (neueste zuerst), mit Cursor-Paginierung. Übergeben Sie language für eine Übersetzung. Erfordert den Scope content:read.

Erforderlicher Scope: content:read

GET /articles/{id}/revisions

Artikelrevisionen auflisten

curl --request GET \
  --url 'https://api.ferndesk.com/v1/articles/{ID}/revisions' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "results": [
    {
      "id": "<string>",
      "version": 1,
      "title": "<string>",
      "source": "<string>",
      "comment": "<string>",
      "createdAt": "<string>"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Revisionen

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 listet den erforderlichen Scope über x-required-scopes auf):

    • content:read: Hilfe-Center-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, deren Veröffentlichung aufheben, wiederherstellen und löschen (Änderungen live schalten)
    • analytics:read: Hilfe-Center-Berichte, Analysen und Artikel-Feedback 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 erstellte Schlüssel haben null Scopes = vollständiger Zugriff (Legacy-Modus).

Path Parameters

  • id string erforderlich

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

Response

application/json
  • results[] object array

    Elemente auf dieser Seite. Zusammenfassung der Revision.

    + Show Child Attributes
    • id string

      Revisions-ID.

    • version integer

      Artikelversion, die diese Revision erfasst hat.

    • title string | null
    • source string | null

      Schreibkanal der Veröffentlichung.

    • comment string | null
    • createdAt string

      ISO-8601-Zeitstempel in UTC.

  • has_more boolean

    Gibt an, ob nach dieser Seite weitere Elemente verfügbar sind.

  • next_cursor string | null

    Cursor, der als start_cursor für die nächste Seite übergeben wird, oder null auf der letzten Seite.