Trigger Notion si sincronizza con l'API Notiondesk

L'API Notiondesk ti permette di pubblicare le modifiche apportate a Notion non appena sono pronte: sincronizza un intero centro assistenza, una raccolta o un singolo articolo, tramite uno script, una pipeline CI o il tuo strumento personalizzato. Puoi anche attivare o disattivare la sincronizzazione programmata. Il tuo contenuto rimane in Notion; la sincronizzazione lo legge nuovamente e pubblica le modifiche.

Non hai mai utilizzato la sincronizzazione? Prima di iniziare, leggi Come sincronizzare il tuo centro assistenza con Notion .

Quando la traduzione automatica è attiva, ogni sincronizzazione traduce il contenuto modificato e lo fattura come caratteri di traduzione. Consulta la pagina Prezzi e fatturazione della traduzione automatica tramite IA prima di automatizzare le sincronizzazioni.

Sincronizza un intero centro assistenza

Notiondesk legge nuovamente ogni articolo e raccolta da Notion e pubblica le modifiche. Il percorso risponde a 204 No Content non appena la sincronizzazione viene messa in coda e la sincronizzazione viene eseguita in background.

È in esecuzione una sola sincronizzazione del sito alla volta. Mentre una sincronizzazione del centro assistenza è in coda o in esecuzione, sia che sia stata pianificata, avviata dalla dashboard o tramite API, un altro trigger risponde con il codice 409 conflict_error. Attendi qualche minuto e riprova.

I contenuti che non sono cambiati dall'ultima sincronizzazione non vengono tradotti nuovamente.

Sincronizza una raccolta

Utilizza il id della collezione dall'elenco delle collezioni . Notiondesk legge nuovamente la collezione e ciascuno dei suoi articoli da Notion, quindi pubblica solo gli articoli modificati dall'ultima sincronizzazione. Gli articoli non modificati non vengono tradotti o fatturati nuovamente.

Sincronizza un articolo

Utilizzare l'articolo id dall'elenco degli articoli .

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 sincronizzazione di un articolo importa nuovamente i file dell'articolo ospitati su Notion: immagini, video, file, audio, PDF e contenuti incorporati caricati su Notion. Per un articolo che contiene uno qualsiasi di questi elementi, ogni chiamata pubblica una nuova revisione e, se la traduzione automatica è attiva, traduce e fattura nuovamente ogni lingua tradotta automaticamente, anche quando il testo è invariato. Notiondesk conserva 50 revisioni per traduzione, quindi le chiamate ripetute rimuovono le revisioni più vecchie dalla cronologia di ripristino.

In che modo la sincronizzazione di raccolte e articoli differisce dalla sincronizzazione del sito?

Ogni sincronizzazione completata aggiorna l'intero centro assistenza. Avvia la sincronizzazione una sola volta dopo ogni modifica in Notion, non tramite un timer. Per aggiornamenti regolari, utilizza invece la sincronizzazione programmata.

Conferma la sincronizzazione

Un trigger di sincronizzazione risponde con 204 quando la sincronizzazione viene messa in coda, non quando termina. Le sincronizzazioni avviate tramite API non vengono visualizzate nello stato di sincronizzazione , che elenca solo le esecuzioni pianificate.

Per confermare la sincronizzazione, leggi il contenuto pubblicato:

1. Avvia la sincronizzazione e annota l'ora.

2. Leggi l'articolo modificato con GET /sites/{site_id}/articles/{article_id} ogni 30 secondi.

3. Fermati quando last_updated è successivo all'ora che hai annotato, oppure quando text mostra la tua modifica.

4. Se sync_failed è true, sync_error_code spiega il perché. Correggi l'articolo in Notion e sincronizza di nuovo.

Attiva o disattiva la sincronizzazione programmata

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

Il percorso risponde a 204 No Content. Leggi il nuovo stato in auto_sync_enabled del centro assistenza e la pianificazione nel suo stato di sincronizzazione.

• Invia i valori booleani JSON true o false. I valori 0 e "false" vengono letti come true.

• La frequenza di sincronizzazione non può essere modificata tramite API: l'invio di auto_sync_frequency restituisce 400 validation_error. Modificala nella dashboard.

• Il tuo piano deve includere la sincronizzazione programmata.

• Attivando la sincronizzazione programmata, le sincronizzazioni non presidiate possono avviare le traduzioni a pagamento anche quando la traduzione automatica è attiva.

Questo percorso necessita dell'ambito sync, non di write, perché decide quando vengono eseguite le sincronizzazioni automatiche.

Errori

conflict_error e request_in_progress sono errori diversi con lo stesso stato: branch su code. Vedi Gestione degli errori API, dei limiti di frequenza e dei tentativi di ripetizione per Notiondesk .

Domande frequenti

Cosa succederà dopo?

• Automatizza le attività comuni del centro assistenza con l'API Notiondesk

• Leggi articoli, raccolte e voci del registro delle modifiche con l'API Notiondesk

• Gestisci le lingue e la traduzione automatica con l'API Notiondesk