Trigger Notion se synchronise avec l'API Notiondesk

L'API Notiondesk vous permet de publier vos modifications Notion dès qu'elles sont prêtes : synchronisez un centre d'aide entier, une collection ou un article, à partir d'un script, d'un pipeline d'intégration continue ou de votre propre outil. Vous pouvez également activer ou désactiver la synchronisation planifiée. Votre contenu reste dans Notion ; une synchronisation le relit et publie les modifications.

Vous débutez avec la synchronisation ? Lisez d’abord « Comment synchroniser votre centre d’aide avec Notion » .

Lorsque la traduction automatique est activée, chaque synchronisation traduit le contenu modifié et est facturée en fonction du nombre de caractères traduits. Consultez la page Tarification et facturation de la traduction automatique par IA avant d'automatiser les synchronisations.

Synchroniser un centre d'aide complet

Notiondesk relit chaque article et collection de Notion et publie les modifications. La route répond 204 No Content dès que la synchronisation est mise en file d'attente, et celle-ci s'exécute en arrière-plan.

Une seule synchronisation de site est exécutée à la fois. Pendant qu'une synchronisation du centre d'aide est en attente ou en cours (qu'elle soit planifiée, lancée depuis le tableau de bord ou via l'API), un autre déclencheur renvoie l'erreur 409 conflict_error. Veuillez patienter quelques minutes avant de relancer la synchronisation.

Les contenus qui n'ont pas été modifiés depuis leur dernière synchronisation ne sont pas traduits à nouveau.

Synchroniser une collection

Utilisez la collection id de la liste des collections . Notiondesk lit à nouveau la collection et chacun de ses articles depuis Notion, puis publie uniquement les articles modifiés depuis leur dernière synchronisation. Les articles inchangés ne sont ni traduits ni facturés à nouveau.

Synchroniser un article

Utilisez l'article id de la liste des articles .

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"

La synchronisation d'un article réimporte les fichiers de l'article hébergés dans Notion : images, vidéos, fichiers, audio, PDF et contenus intégrés. Pour un article contenant l'un de ces éléments, chaque synchronisation publie une nouvelle version. Lorsque la traduction automatique est activée, la traduction et la facturation sont relancées pour chaque langue, même si le texte reste inchangé. Notiondesk conserve 50 versions par traduction ; les synchronisations répétées suppriment donc les versions les plus anciennes de l'historique de restauration.

En quoi la synchronisation des collections et des articles diffère-t-elle de la synchronisation d'un site ?

Chaque synchronisation effectuée actualise l'intégralité du centre d'aide. Déclenchez une synchronisation après chaque modification dans Notion, et non à intervalles réguliers. Pour des mises à jour régulières, utilisez plutôt la synchronisation planifiée.

Confirmer une synchronisation

Un déclencheur de synchronisation répond 204 lorsque la synchronisation est mise en file d'attente, et non lorsqu'elle est terminée. Les synchronisations lancées via l'API n'apparaissent pas dans l' état de synchronisation , qui ne répertorie que les exécutions planifiées.

Pour confirmer une synchronisation, consultez le contenu qu'elle publie :

1. Déclenchez la synchronisation et notez l'heure.

2. Lisez l'article modifié avec GET /sites/{site_id}/articles/{article_id} toutes les 30 secondes.

3. Arrêtez-vous lorsque last_updated est plus tard que l'heure que vous avez notée, ou lorsque text affiche votre modification.

4. Si sync_failed est true, sync_error_code explique pourquoi. Corrigez l'article dans Notion et synchronisez à nouveau.

Activer ou désactiver la synchronisation programmée

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

La route répond 204 No Content. Lisez le nouvel état dans auto_sync_enabled du centre d'aide et la planification dans son état de synchronisation.

• Envoyez les booléens JSON true ou false. Les valeurs 0 et "false" sont lues comme true.

• La fréquence de synchronisation ne peut pas être modifiée via l'API : l'envoi de auto_sync_frequency renvoie 400 validation_error. Modifiez-la dans le tableau de bord.

• Votre forfait doit inclure une synchronisation programmée.

• L'activation de la synchronisation planifiée permet aux synchronisations sans intervention de démarrer la traduction facturée même lorsque la traduction automatique est activée.

Cette route a besoin de la portée sync, et non de write, car elle détermine quand les synchronisations non supervisées s'exécutent.

Erreurs

conflict_error et request_in_progress sont des erreurs différentes ayant le même statut : branchement sur code. Voir Gestion des erreurs d’API, des limites de débit et des nouvelles tentatives de Notiondesk .

Questions fréquentes

Et ensuite ?

• Automatisez les tâches courantes du centre d'assistance grâce à l'API Notiondesk

• Lisez les articles, les collections et les entrées du journal des modifications avec l'API Notiondesk

• Gérez les langues et la traduction automatique avec l'API Notiondesk