API roundup: ultimi aggiornamenti per ONLYOFFICE DocSpace e Docs

2 settembre 2025Da Elena

Gli aggiornamenti di agosto 2025 per le API di ONLYOFFICE DocSpace e Docs portano una nuova ondata di possibilità di integrazione e strumenti di sviluppo. Che tu stia costruendo flussi di lavoro documentali, creando plugin personalizzati o collegando ONLYOFFICE al tuo stack tecnologico esistente, questi aggiornamenti offrono soluzioni pratiche che fanno risparmiare tempo e semplificano lo sviluppo.

API roundup: latest updates for ONLYOFFICE DocSpace and Docs

DocSpace: esempi di integrazione per Backend REST API

L’ultimo aggiornamento delle API di DocSpace include esempi di integrazione completi che dimostrano casi d’uso reali. Non si tratta solo di frammenti di codice, ma di soluzioni complete che puoi adattare ai tuoi progetti.

Integrazioni con Trello

Sincronizzazione bidirezionale degli utenti. Sincronizza automaticamente gli utenti tra DocSpace e le board Trello. Questo elimina l’onboarding manuale e garantisce coerenza del team tra piattaforme. Aggiungi utenti DocSpace a Trello / Aggiungi utenti Trello a DocSpace

Migrazione degli asset. Importa gli allegati delle card Trello direttamente nelle stanze DocSpace. Questo scenario semplifica i passaggi di consegna dei progetti e centralizza la documentazione.

Mirroring della struttura dei progetti. Crea stanze DocSpace direttamente dalle board Trello con titoli corrispondenti. Perfetto per mantenere un’organizzazione unificata dei progetti. Esempio di codice:

import requests

# ONLYOFFICE DocSpace configuration
ONLYOFFICE_API_HOST = "your-docspace.onlyoffice.com"
ONLYOFFICE_API_KEY = "your_onlyoffice_api_key"

# Trello configuration
TRELLO_API_KEY = "your_trello_api_key"
TRELLO_TOKEN = "your_trello_token"
TRELLO_BOARD_ID = "your_board_id"

ONLYOFFICE_HEADERS = {
    "Authorization": f"Bearer {ONLYOFFICE_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json"
}

# Step 1: Get Trello board name
def get_trello_board_name(board_id):
    url = f"https://api.trello.com/1/boards/{board_id}"
    params = {"key": TRELLO_API_KEY, "token": TRELLO_TOKEN}
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()["name"]
    else:
        print(f"Trello board fetch error: {response.status_code}")
        return None

# Step 2: Create a DocSpace room with board name
def create_docspace_room(room_title):
    url = f"https://{ONLYOFFICE_API_HOST}/api/2.0/files/rooms"
    payload = {
        "title": room_title,
        "roomType": 2,  # Collaboration room
        "private": True
    }
    response = requests.post(url, headers=ONLYOFFICE_HEADERS, json=payload)
    if response.status_code == 200:
        print(f"Room created: {room_title}")
        return response.json()
    else:
        print(f"DocSpace room creation error: {response.status_code}, {response.text}")
        return None

# Run integration
if __name__ == "__main__":
    board_name = get_trello_board_name(TRELLO_BOARD_ID)
    if board_name:
        create_docspace_room(board_name)

Integrazioni con archiviazione cloud

Connettività con Dropbox. Le nuove integrazioni con Dropbox supportano flussi di lavoro sia di importazione che di esportazione. Esporta file da DocSpace usando URL presignati per archiviazione o backup. Importa file direttamente in stanze specifiche per una gestione documentale centralizzata.

Automazione della condivisione delle cartelle. Condividi automaticamente cartelle Dropbox con utenti o membri di gruppi DocSpace, creando ponti collaborativi fluidi tra piattaforme.

Workflow con Notion e Asana

Integrazione utenti Notion. Sincronizza gli utenti dello spazio di lavoro Notion con DocSpace, garantendo accesso coerente in tutto l’ecosistema documentale.

Automazione progetti Asana. Genera strutture di stanze DocSpace basate su progetti Asana, con cartelle create automaticamente per ciascun task. Ciò consente un perfetto allineamento tra gestione progetti e collaborazione documentale.

Inviti basati su task. Invita automaticamente gli assegnatari dei task Asana nelle stanze DocSpace rilevanti, eliminando la gestione manuale degli accessi.

DocSpace: Plugins SDK potenziato

Il Plugins SDK riceve aggiornamenti significativi con esempi sia avanzati che di base per accelerare lo sviluppo di plugin.

Esempi di plugin avanzati

Plugin filtro estensioni file. Aggiunge capacità di filtraggio contestuale con un’interfaccia modale pulita. Gli utenti possono filtrare i contenuti delle stanze per tipo di file, migliorando la navigazione in ambienti ricchi di documenti.
Plugin finestra modale. Dimostra l’integrazione personalizzata della toolbar con chiamate API backend. Crea nuovi documenti direttamente dall’interfaccia con parametri definiti dall’utente.
UI plugin impostazioni. Fornisce agli amministratori interfacce di configurazione personalizzate, consentendo un controllo dettagliato del comportamento dei plugin.

Esempi di componenti di base

I nuovi esempi di base coprono componenti UI essenziali:

Plugin API – mostra la corretta gestione della connessione API della piattaforma.
Componente Box – esempi di configurazione layout e spaziatura.
Componente Button – implementazione di elementi interattivi.
Componente ComboBox – interfacce di selezione a tendina.
Componente Text – opzioni di tipografia e stile.
Componente ToggleButton – controlli a stato binario.

Questi esempi forniscono i mattoni di base per uno sviluppo plugin più complesso, con schemi di implementazione chiari da seguire.

Novità per Docs API: Personalizzazione

Il nuovo parametro suggestFeature ti offre un controllo granulare sul nuovo elemento dell’interfaccia dell’editor.

const config = {
  editorConfig: {
    customization: {
...
suggestFeature: true,

Questo parametro controlla la visibilità del pulsante di menu “Suggerisci una funzionalità” nella scheda File. Impostalo su false per implementazioni interne in cui i suggerimenti non sono rilevanti, oppure mantienilo su true per favorire il coinvolgimento degli utenti nello sviluppo del prodotto.

API roundup: latest updates for ONLYOFFICE DocSpace and Docs

Docs: nuovi esempi per Office API

Per supportare casi d’uso diversificati, abbiamo introdotto nuovi esempi di creazione documenti con applicazioni pratiche.

Numeri sequenziali. Migliora la navigazione nelle tabelle e il riferimento alle righe aggiungendo numerazione sequenziale alla prima colonna.
Creazione tabelle formattate. Format automatico delle tabelle in fase di creazione con bordi, intestazioni stilizzate e testo allineato nelle celle. Perfetto per report, esportazioni di database o template leggibili.
Foglio di calcolo con filtri. Genera un foglio di calcolo con filtri interattivi nelle intestazioni, consentendo agli utenti di ordinare e filtrare facilmente i dati.
Piè di pagina con data e nome azienda. Aggiungi automaticamente un piè di pagina al documento con la data corrente da un lato e il nome della tua azienda dall’altro. Ideale per memo, report, lettere e template standard.
Tabella a larghezza automatica. Genera un documento con una tabella che adatta dinamicamente la larghezza delle colonne al contenuto.
Elenco puntato di task. Genera un documento con un elenco puntato chiaro e organizzato, perfetto per attività, passaggi o requisiti.