Trigger Notion synchroniseert met de Notiondesk API

Met de Notiondesk API kunt u uw Notion-bewerkingen publiceren zodra ze klaar zijn: synchroniseer een volledig helpcentrum, een collectie of een artikel, vanuit een script, een CI-pipeline of uw eigen tool. U kunt geplande synchronisatie ook in- of uitschakelen. Uw content blijft in Notion; een synchronisatie leest deze opnieuw en publiceert de wijzigingen.

Nieuw met synchroniseren? Lees dan eerst Hoe u uw helpcentrum met Notion synchroniseert .

Wanneer automatische vertaling is ingeschakeld, vertaalt elke synchronisatie de gewijzigde inhoud en worden de kosten hiervan in rekening gebracht als vertaaltekens. Raadpleeg de prijs- en factureringsinformatie voor automatische AI-vertaling voordat u synchronisaties automatiseert.

Synchroniseer een volledig helpcentrum

Notiondesk leest alle artikelen en collecties van Notion opnieuw en publiceert de wijzigingen. De route beantwoordt 204 No Content zodra de synchronisatie in de wachtrij staat, en de synchronisatie wordt op de achtergrond uitgevoerd.

Er wordt slechts één sitesynchronisatie tegelijk uitgevoerd. Terwijl een synchronisatie van het helpcentrum in de wachtrij staat of bezig is (ongeacht of deze is gepland, gestart vanuit het dashboard of via de API), geeft een andere trigger de foutmelding 409 conflict_error. Wacht een paar minuten en voer de trigger opnieuw uit.

Inhoud die sinds de laatste synchronisatie niet is gewijzigd, wordt niet opnieuw vertaald.

Synchroniseer één collectie

Gebruik de id van de collectie uit de collectielijst . Notiondesk leest de collectie en elk van de artikelen daarin opnieuw uit Notion en publiceert vervolgens alleen de artikelen die sinds de laatste synchronisatie zijn bewerkt. Onveranderde artikelen worden niet opnieuw vertaald of gefactureerd.

Synchroniseer één artikel

Gebruik het artikel id uit de artikellijst .

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"

Een artikelsynchronisatie importeert de in Notion gehoste bestanden van het artikel opnieuw: afbeeldingen, video's, bestanden, audio, pdf's en ingesloten content die naar Notion zijn geüpload. Voor een artikel dat een of meer van deze bestanden bevat, publiceert elke synchronisatie een nieuwe revisie. Zolang automatische vertaling is ingeschakeld, worden alle automatisch vertaalde talen opnieuw vertaald en gefactureerd, zelfs als de tekst ongewijzigd is. Notiondesk bewaart 50 revisies per vertaling, waardoor herhaalde synchronisatieverzoeken oudere revisies uit de herstelgeschiedenis verwijderen.

Hoe het synchroniseren van collecties en artikelen verschilt van het synchroniseren van een hele site

Elke voltooide synchronisatie vernieuwt het hele helpcentrum. Start een synchronisatie eenmaal na elke bewerking in Notion, niet op basis van een timer. Gebruik voor regelmatige updates de geplande synchronisatiefunctie.

Bevestig een synchronisatie

Een synchronisatietrigger geeft de foutmelding 204 wanneer de synchronisatie in de wachtrij wordt geplaatst, niet wanneer deze is voltooid. Synchronisaties die via de API worden gestart, verschijnen niet in de synchronisatiestatus , die alleen geplande uitvoeringen weergeeft.

Om een ​​synchronisatie te bevestigen, lees je de inhoud die wordt gepubliceerd:

1. Start de synchronisatie en noteer de tijd.

2. Lees het bewerkte artikel met GET /sites/{site_id}/articles/{article_id} elke 30 seconden.

3. Stop wanneer last_updated later is dan de tijd die je hebt genoteerd, of wanneer text je bewerking weergeeft.

4. Als sync_failed true is, geeft sync_error_code aan waarom. Corrigeer het artikel in Notion en synchroniseer opnieuw.

Schakel geplande synchronisatie in of uit.

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}'

De route geeft antwoord 204 No Content. Lees de nieuwe status in auto_sync_enabled van het helpcentrum en de planning in de synchronisatiestatus.

• Verzend de JSON-booleans true of false. De waarden 0 en "false" worden gelezen als true.

• De synchronisatiefrequentie kan niet via de API worden gewijzigd: het verzenden van auto_sync_frequency resulteert in 400 validation_error. Wijzig deze in het dashboard.

• Uw abonnement moet geplande synchronisatie omvatten.

• Door geplande synchronisatie in te schakelen, kunnen geautomatiseerde synchronisaties de gefactureerde vertaling starten terwijl automatische vertaling is ingeschakeld.

Deze route heeft de scope sync nodig, niet write, omdat deze bepaalt wanneer onbeheerde synchronisaties worden uitgevoerd.

Fouten

conflict_error en request_in_progress zijn verschillende fouten met dezelfde status: vertakking op code. Zie API-fouten, snelheidslimieten en herhaalpogingen afhandelen voor Notiondesk .

Veelgestelde vragen

Wat volgt?

• Automatiseer veelvoorkomende helpcentrumtaken met de Notiondesk API

• Lees artikelen, collecties en wijzigingslogboeken met de Notiondesk API

• Beheer talen en automatische vertaling met de Notiondesk API