Trigger Notion synchronisiert sich mit der Notiondesk API

Mit der Notiondesk API können Sie Ihre Notion-Änderungen sofort veröffentlichen: Synchronisieren Sie ein komplettes Hilfecenter, eine Sammlung oder einen einzelnen Artikel – per Skript, CI-Pipeline oder Ihrem eigenen Tool. Sie können die geplante Synchronisierung auch aktivieren oder deaktivieren. Ihre Inhalte bleiben in Notion erhalten; bei einer Synchronisierung werden sie erneut gelesen und die Änderungen veröffentlicht.

Sie haben noch keine Erfahrung mit der Synchronisierung? Lesen Sie zuerst , wie Sie Ihr Hilfezentrum mit Notion synchronisieren .

Wenn die automatische Übersetzung aktiviert ist, übersetzt jede Synchronisierung die geänderten Inhalte und berechnet diese als Übersetzungszeichen. Informieren Sie sich über die Preise und Abrechnung der automatischen KI-Übersetzung, bevor Sie Synchronisierungen automatisieren.

Synchronisieren Sie ein ganzes Hilfezentrum

Notiondesk liest alle Artikel und Sammlungen von Notion erneut und veröffentlicht die Änderungen. Die Route antwortet mit 204 No Content, sobald die Synchronisierung in die Warteschlange gestellt wird, und die Synchronisierung läuft im Hintergrund.

Es wird immer nur eine Website-Synchronisierung gleichzeitig ausgeführt. Während die Synchronisierung des Hilfecenters in der Warteschlange steht oder läuft (unabhängig davon, ob sie geplant, über das Dashboard oder die API gestartet wurde), antwortet ein anderer Trigger mit dem Fehlercode 409 conflict_error. Warten Sie einige Minuten und versuchen Sie es erneut.

Inhalte, die sich seit der letzten Synchronisierung nicht geändert haben, werden nicht erneut übersetzt.

Eine Sammlung synchronisieren

Verwenden Sie die id-Kennung der Sammlung aus der Sammlungsliste . Notiondesk liest die Sammlung und alle darin enthaltenen Artikel erneut aus Notion ein und veröffentlicht anschließend nur die Artikel, die seit der letzten Synchronisierung bearbeitet wurden. Unveränderte Artikel werden nicht erneut übersetzt oder abgerechnet.

Einen Artikel synchronisieren

Verwenden Sie den Artikel mit der ID id aus der Artikelliste .

curl -i -X POST "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Idempotency-Key: 9b2e4c1a-sync-after-notion-edit"

curl -i -X POST "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/categories/1761493027/sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Idempotency-Key: 2c8e5b7d-sync-billing"

curl -i -X POST "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/articles/1761580412/sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Idempotency-Key: 4d7a0f3e-sync-getting-started"

Die Artikelsynchronisierung importiert die in Notion gespeicherten Artikeldateien erneut: Bilder, Videos, Dateien, Audiodateien, PDFs und eingebettete Inhalte, die in Notion hochgeladen wurden. Bei Artikeln, die eine dieser Dateien enthalten, wird mit jedem Aufruf eine neue Version veröffentlicht. Solange die automatische Übersetzung aktiviert ist, werden alle automatisch übersetzten Sprachen erneut übersetzt und abgerechnet, selbst wenn der Text unverändert ist. Notiondesk speichert 50 Versionen pro Übersetzung, sodass wiederholte Aufrufe ältere Versionen aus dem Wiederherstellungsverlauf verdrängen.

Wie sich die Synchronisierung von Sammlungen und Artikeln von einer Website-Synchronisierung unterscheidet

Nach jeder abgeschlossenen Synchronisierung wird das gesamte Hilfecenter aktualisiert. Starten Sie die Synchronisierung einmalig nach jeder Bearbeitung in Notion, nicht zeitgesteuert. Für regelmäßige Aktualisierungen verwenden Sie stattdessen die geplante Synchronisierung.

Synchronisierung bestätigen

Ein Synchronisierungstrigger antwortet mit 204, wenn die Synchronisierung in die Warteschlange gestellt wird, nicht nach deren Abschluss. Über die API gestartete Synchronisierungen werden nicht im Synchronisierungsstatus angezeigt, da dort nur geplante Ausführungen aufgelistet sind.

Um eine Synchronisierung zu bestätigen, lesen Sie die veröffentlichten Inhalte:

1. Die Synchronisierung auslösen und die Uhrzeit notieren.

2. Lesen Sie den bearbeiteten Artikel alle 30 Sekunden mit GET /sites/{site_id}/articles/{article_id}.

3. Stoppen Sie, wenn last_updated nach dem von Ihnen notierten Zeitpunkt liegt oder text Ihre Bearbeitung anzeigt.

4. Wenn sync_failed gleich true ist, gibt sync_error_code den Grund dafür an. Korrigieren Sie den Artikel in Notion und synchronisieren Sie ihn erneut.

Geplante Synchronisierung aktivieren oder deaktivieren

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/auto-sync" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"auto_sync_enabled": true}'

Die Route beantwortet 204 No Content. Lesen Sie den neuen Status in auto_sync_enabled des Hilfecenters und den Zeitplan in seinem Synchronisierungsstatus.

• Senden Sie die JSON-Booleschen Werte true oder false. Die Werte 0 und "false" werden als true interpretiert.

• Die Synchronisierungsfrequenz kann nicht über die API geändert werden: Das Senden von auto_sync_frequency führt zu einer 400 validation_error-Antwort. Ändern Sie sie im Dashboard.

• Ihr Plan muss eine geplante Synchronisierung beinhalten.

• Durch die Aktivierung der geplanten Synchronisierung können unbeaufsichtigte Synchronisierungen die kostenpflichtige Übersetzung starten, während die automatische Übersetzung aktiviert ist.

Diese Route benötigt den Bereich sync, nicht write, da sie festlegt, wann unbeaufsichtigte Synchronisierungen ausgeführt werden.

Fehler

conflict_error und request_in_progress sind unterschiedliche Fehler mit demselben Status: Verzweigung bei code. Siehe „Behandlung von Notiondesk API-Fehlern, Ratenbegrenzungen und Wiederholungsversuchen“ .

Häufig gestellte Fragen

Was kommt als Nächstes?

• Automatisieren Sie häufige Aufgaben im Hilfecenter mit der Notiondesk API

• Lesen Sie Artikel, Sammlungen und Änderungsprotokolleinträge mit der Notiondesk API.

• Sprachen verwalten und automatische Übersetzungen mit der Notiondesk API durchführen