Ferndesk

Artikelrevisionen

Artikelrevision wiederherstellen

Stellt eine alte Revision wieder her, indem sie als neuer Entwurf bereitgestellt und über dem aktuellen Head veröffentlicht wird (die Historie bleibt linear). Erfordert den Bereich content:publish.

Erforderlicher Bereich: content:publish

POST /articles/{id}/revisions/{revisionId}/restore

Artikelrevision wiederherstellen

curl --request POST \
  --url 'https://api.ferndesk.com/v1/articles/{ID}/revisions/{REVISIONID}/restore' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "articleId": "<string>",
  "language": "<string>",
  "restoredFromVersion": 1,
  "newVersion": 1
}

Wiederhergestellt

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 auf der Seite Developer settings erstellen und verwalten.

    Schlüssel können auf eine beliebige Teilmenge dieser Bereiche beschränkt werden (jeder Endpunkt führt den erforderlichen Bereich ü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, die Veröffentlichung aufheben, wiederherstellen und in den Papierkorb verschieben (Ä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 der Bereichsbeschränkung erstellte Schlüssel haben null Bereiche = vollständiger Zugriff (Legacy-Modus).

Path Parameters

  • id string erforderlich

    Ferndesk-Artikel-ID (art_...). Beispiel: art_01JXY9AZK4KV

  • revisionId string erforderlich

    Revisions-ID. Beispiel: rev_01JXY9AZK4KV

Response

application/json
  • articleId string

    Artikel, der wiederhergestellt wurde.

  • language string

    Sprache der wiederhergestellten Revision.

  • restoredFromVersion integer

    Versionsnummer der wiederhergestellten Revision.

  • newVersion integer | null

    Neue Head-Version, die durch die Wiederherstellung für die Primärsprache erstellt wurde, oder null bei der Wiederherstellung einer Übersetzung.