Trigger Notion synchronizuje się z API Notiondesk

Interfejs API Notiondesk umożliwia publikowanie zmian w Notion w momencie ich przygotowania: synchronizuj całe centrum pomocy, jedną kolekcję lub jeden artykuł, ze skryptu, procesu ciągłej integracji (CI) lub własnego narzędzia. Możesz również włączać i wyłączać synchronizację planową. Twoja zawartość pozostaje w Notion; synchronizacja odczytuje ją ponownie i publikuje zmiany.

Dopiero zaczynasz synchronizować? Przeczytaj najpierw , jak zsynchronizować Centrum pomocy z Notion .

Gdy automatyczne tłumaczenie jest włączone, każda synchronizacja tłumaczy zmienioną treść i rozlicza ją jako znaki tłumaczenia. Przed zautomatyzowaniem synchronizacji zapoznaj się z cennikiem i rozliczeniami automatycznego tłumaczenia AI .

Synchronizuj całe centrum pomocy

Notiondesk ponownie odczytuje każdy artykuł i kolekcję z Notion i publikuje zmiany. Trasa odpowiada na 204 No Content, gdy tylko synchronizacja zostanie umieszczona w kolejce, a synchronizacja działa w tle.

Synchronizacja tylko jednej witryny jest wykonywana w danym momencie. Podczas gdy synchronizacja centrum pomocy jest w kolejce lub jest w trakcie, niezależnie od tego, czy została zaplanowana, uruchomiona z pulpitu nawigacyjnego, czy za pośrednictwem API, inny wyzwalacz odpowiada na błąd 409 conflict_error. Odczekaj kilka minut i wyzwól ponownie.

Treści, które nie uległy zmianie od ostatniej synchronizacji, nie są ponownie tłumaczone.

Synchronizuj jedną kolekcję

Użyj id kolekcji z listy kolekcji . Notiondesk odczytuje kolekcję i wszystkie jej artykuły z Notion ponownie, a następnie publikuje tylko artykuły edytowane od ostatniej synchronizacji. Niezmienione artykuły nie są ponownie tłumaczone ani rozliczane.

Synchronizuj jeden artykuł

Użyj id artykułu z listy artykułów .

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"

Synchronizacja artykułu ponownie importuje pliki artykułu hostowane w Notion: obrazy, filmy, pliki audio, pliki PDF i osadzenia przesłane do Notion. W przypadku artykułu zawierającego którykolwiek z nich, każde wywołanie publikuje nową wersję, a gdy automatyczne tłumaczenie jest włączone, ponownie tłumaczy i rozlicza każdy automatycznie tłumaczony język, nawet jeśli tekst nie uległ zmianie. Notiondesk przechowuje 50 wersji dla każdego tłumaczenia, więc wielokrotne wywołania usuwają starsze wersje z historii przywracania.

Czym synchronizacja kolekcji i artykułów różni się od synchronizacji witryny

Każda ukończona synchronizacja odświeża całe centrum pomocy. Synchronizuj raz po każdej edycji w Notion, a nie według timera. W przypadku regularnych aktualizacji użyj synchronizacji zaplanowanej.

Potwierdź synchronizację

Wyzwalacz synchronizacji odpowiada na 204, gdy synchronizacja jest w kolejce, a nie po jej zakończeniu. Synchronizacje rozpoczęte za pośrednictwem interfejsu API nie są wyświetlane w statusie synchronizacji , który zawiera jedynie listę zaplanowanych uruchomień.

Aby potwierdzić synchronizację, przeczytaj publikowaną treść:

1. Uruchom synchronizację i zanotuj czas.

2. Przeczytaj edytowany artykuł z GET /sites/{site_id}/articles/{article_id} co 30 sekund.

3. Zatrzymaj się, gdy last_updated jest późniejszy niż zanotowany czas lub gdy text pokazuje Twoją edycję.

4. Jeśli sync_failed to true, sync_error_code wyjaśnia przyczynę. Napraw artykuł w Notion i zsynchronizuj ponownie.

Włącz lub wyłącz synchronizację planową

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

Trasa odpowiada 204 No Content. Przeczytaj nowy stan w auto_sync_enabled w Centrum pomocy oraz harmonogram w jego statusie synchronizacji.

• Wyślij wartości logiczne JSON true lub false. Wartości 0 i "false" są odczytywane jako true.

• Częstotliwości synchronizacji nie można zmienić za pomocą interfejsu API: wysyłanie odpowiedzi auto_sync_frequency 400 validation_error. Zmień ją w panelu.

• Twój plan musi obejmować zaplanowaną synchronizację.

• Włączenie synchronizacji zaplanowanej umożliwia nienadzorowanym synchronizacjom rozpoczęcie tłumaczenia płatnego, gdy włączone jest tłumaczenie automatyczne.

Ta trasa wymaga zakresu sync, a nie write, ponieważ decyduje on, kiedy uruchamiane są nienadzorowane synchronizacje.

Błędy

conflict_error i request_in_progress to różne błędy o tym samym statusie: rozgałęzienie na code. Zobacz Obsługa błędów API Notiondesk, limitów szybkości i ponownych prób .

Często zadawane pytania

Co dalej?

• Zautomatyzuj typowe zadania centrum pomocy za pomocą interfejsu API Notiondesk

• Czytaj artykuły, kolekcje i wpisy w dzienniku zmian za pomocą interfejsu API Notiondesk

• Zarządzaj językami i automatycznym tłumaczeniem za pomocą interfejsu API Notiondesk