Consulta i tuoi centri di assistenza con l'API Notiondesk

L'API Notiondesk ti permette di elencare tutti i centri di assistenza nel tuo spazio di lavoro, leggere la configurazione di ciascun centro di assistenza e controllare lo stato della sua sincronizzazione Notion pianificata. Inizia da qui: il centro di assistenza id restituito da questi percorsi è il site_id che ogni altro percorso dell'API Notiondesk prende nel suo percorso.

Nell'API Notiondesk, un centro assistenza è chiamato sito .

Elenca i tuoi centri di assistenza

L'elenco comprende tutti i centri di assistenza presenti nell'area di lavoro proprietaria della tua chiave, dal più vecchio al più recente, utilizzando la paginazione del cursore con page_size e cursor.

curl "https://api.notiondesk.so/sites?page_size=50" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

{
  "object": "list",
  "data": [
    {
      "id": "c74781f6-1aea-4e17-ab23-bbb8b4d174b6",
      "full_domain": "help.example.com",
      "enabled": true,
      "default_locale": "en",
      "locales": ["en", "fr"]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Gestisci più centri di assistenza? Consulta la sezione Creare più centri di assistenza .

Leggere la configurazione di un centro assistenza

La risposta descrive il centro assistenza e ogni impostazione che l'API può modificare. Rileggila dopo un aggiornamento delle impostazioni per confermare il nuovo stato: le route delle impostazioni rispondono 204 No Content senza corpo.

curl "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

{
  "id": "c74781f6-1aea-4e17-ab23-bbb8b4d174b6",
  "full_domain": "help.example.com",
  "enabled": true,
  "default_locale": "en",
  "access_mode": "public",
  "guest_access_requires_login": true,
  "supported_locales": ["en", "fr"],
  "available_locales": ["en", "fr", "de", "es"],
  "auto_sync_enabled": true,
  "seo_indexing_enabled": true,
  "setting_content_items": [
    {"locale": "en", "page_title": "Example Help Center", "page_description": "Answers about Example"}
  ],
  "auto_translate_enabled": false,
  "auto_translate_source_locale": null,
  "llms_txt_enabled": true,
  "markdown_export_enabled": true,
  "ai_contextual_menu_enabled": false,
  "mcp_search_enabled": true,
  "contact_form_enabled": true,
  "changelog_enabled": true,
  "changelog_email_subscriptions_enabled": false,
  "changelog_reactions_enabled": true,
  "changelog_email_subject_pattern": null,
  "changelog_categories": [
    {"category_id": "2984612035", "color": "blue_sky"}
  ]
}

Verifica lo stato della sincronizzazione programmata

La risposta corrisponde allo stesso stato mostrato nella dashboard per le sincronizzazioni programmate:

curl "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/sync-status" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

{
  "auto_sync_enabled": true,
  "frequency": "daily",
  "next_sync_at": "2026-10-19T06:00:00+00:00",
  "current_status": "idle",
  "recent_runs": [
    {
      "started_at": "2026-10-18T06:00:02+00:00",
      "finished_at": "2026-10-18T06:01:41+00:00",
      "status": "success",
      "message": "Synced successfully.",
      "error_category": null,
      "requires_customer_action": false
    }
  ]
}

Ogni esecuzione ha started_at, finished_at (null mentre è in esecuzione e per un'esecuzione che è andata in timeout), status (in_progress, success o failed), un breve message e per un'esecuzione fallita:

Quando requires_customer_action è true, anche l'esecuzione successiva fallisce finché non si risolve un problema, ad esempio la connessione a Notion. Consulta la sezione Come sincronizzare il centro assistenza con Notion .

Lo stato di sincronizzazione elenca solo le esecuzioni pianificate. Una sincronizzazione attivata tramite API o dashboard non viene visualizzata. Consulta la sezione Attiva le sincronizzazioni di Notion con l'API Notiondesk per confermare una sincronizzazione attivata.recent_runs

Errori

Ogni percorso può anche rispondere a invalid_version, authentication_error, rate_limited e internal_error. Vedi Gestione degli errori API, dei limiti di frequenza e dei tentativi di ripetizione per Notiondesk .

Domande frequenti

Cosa succederà dopo?

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

• Trigger Notion si sincronizza con l'API Notiondesk

• Aggiorna le impostazioni del centro assistenza con l'API Notiondesk