Scopri l'API di Dlubal

La Dlubal API è un'interfaccia programmabile (Application Programming Interface) che consente di accedere direttamente alle funzionalità dei programmi Dlubal. Attualmente, l'API è disponibile per RFEM 6 e RSTAB 9 e in futuro lo sarà anche per RSECTION, RWIND e Geo-Zone Tool.

Utilizzando la Dlubal API, è possibile automatizzare in modo efficiente attività ripetitive e dispendiose in termini di tempo, creare flussi di lavoro personalizzati e sviluppare soluzioni personalizzate per processi interni e progetti specifici dei clienti. Tra i tipici ambiti di applicazione figurano la modellazione e l'inserimento automatico dei dati, studi di varianti per l'ottimizzazione delle strutture, verifiche di progetto definite dall'utente e interfacce con altre soluzioni software.

Inoltre, l'API consente di progettare i flussi di lavoro in modo flessibile e indipendente dall'interfaccia utente del software Dlubal. È possibile creare script e programmi personalizzati che soddisfano esattamente le proprie esigenze e si integrano perfettamente nei processi esistenti.

Saremo lieti di fornirvi una consulenza personalizzata sulle vostre esigenze specifiche e di supportarvi nell'integrazione dell'API nel vostro processo di lavoro.

Per utilizzare l'API Dlubal, è necessaria una licenza valida (versione completa o di prova) di un programma principale Dlubal supportato (attualmente RFEM 6 e RSTAB 9, in futuro anche RSECTION, RWIND e Geo-Zone Tool) e una chiave API personale. È possibile generare facilmente questa chiave API tramite il proprio account Extranet Dlubal, selezionando "API e Cloud → API II → Le mie chiavi API":

L'abbonamento API non è obbligatorio: è possibile iniziare direttamente con l'abbonamento API gratuito "Free" e iniziare a conoscere e utilizzare l'API senza impegno.

La nuova API Dlubal si basa sulla moderna tecnologia gRPC e attualmente supporta principalmente Python. È possibile installare facilmente il ‘’'Python client'‘’ ufficiale tramite PyPI. La documentazione dell'API Dlubal fornisce numerosi esempi di codice per aiutarvi a iniziare.

Una nuova aggiunta è il ‘’'C# client'‘’, disponibile comodamente tramite NuGet.

Tuttavia, consigliamo comunque Python per la maggior parte dei casi d'uso. Il linguaggio è facile da imparare, consente uno sviluppo di prototipi estremamente rapido, offre un'ampia selezione di librerie e beneficia di una community particolarmente attiva.

La nuova API Dlubal supporta attualmente RFEM 6, RSTAB 9 e RSECTION 1. In futuro, sarà disponibile anche per RWIND e Geo-Zone Tool. Sono compatibili le licenze complete del programma, le licenze accademiche e per studenti e le versioni di prova. Il supporto per le versioni demo è attualmente in fase di preparazione.

L'API Dlubal viene aggiornata regolarmente insieme ai programmi principali supportati (attualmente RFEM 6 e RSTAB 9, in futuro RSECTION e RWIND). Per garantire una compatibilità ottimale, si consiglia di utilizzare sempre la versione API corrispondente al numero di patch e di versione minore del programma principale installato. Ad esempio: la versione RFEM 6.10.0007 deve essere utilizzata con la versione API 2.10.7.

L'API viene costantemente ampliata e ottimizzata. Per rimanere aggiornati, si consiglia di consultare regolarmente i report degli ultimi aggiornamenti nella sezione "Release" della documentazione ufficiale dell'API Dlubal.

Il futuro Dlubal MCP Server è attualmente in fase di sviluppo attivo per consentire un accesso basato su IA a tutti i dati e le funzioni di RFEM e RSTAB. Serve come una middleware orientata ai servizi tra le vostre applicazioni e i programmi Dlubal RFEM e RSTAB. Il suo concetto si basa su tre pilastri principali:

1. Livello API aperta - Endpoint REST e WebSocket chiaramente documentati racchiudono tutte le funzioni di modellazione, risultati e dimensionamento. Ciò consente di interagire con RFEM/RSTAB in modo completamente indipendente dalla piattaforma.

2. Bus dati in tempo reale - Le modifiche al modello e tutti i dati RFEM/RSTAB rilevanti - inclusi i casi di carico, le forze interne o i risultati del dimensionamento - vengono trasmessi in tempo reale. Ciò consente ai sistemi esterni di accedervi immediatamente, avviare calcoli automaticamente o attivare altre azioni.

3. Orchestrazione IA - Un motore IA integrato traduce automaticamente input linguistici naturali o compiti di ottimizzazione in richieste API appropriate - proprio come se steste dando comandi a un chatbot IA come la nostra assistente Mia. Esempi di ciò includono:

• Crea una nuova asta in acciaio S235 con sezione trasversale IPE 200 tra i nodi 5 e 8.
• Dammi tutte le forze interne dell'asta 12 nel caso di carico 5.
• Dammi l'asta più critica nel modello.
• Trova la sezione trasversale più sfruttata della serie profili HE-A per l'asta 21.
• Importa il file DXF xxxxx.dxf come sfondo.
• Modella una sala 3D con i seguenti parametri: larghezza, altezza, profondità, inclinazione del tetto, …

Tutte queste istruzioni vengono poi implementate automaticamente nel vostro modello dal server MCP.

In sintesi: Il futuro Dlubal MCP Server diventerà il fulcro di un nuovo mondo di ingegneria strutturale aperta e connessa. Alla base di questo c'è il Model Context Protocol (MCP), uno standard aperto per il collegamento di modelli IA con strumenti e fonti di dati esterni. Ciò consente di interfacciare RFEM o RSTAB con quasi qualsiasi applicazione con poche righe di codice. Che si tratti di software CAD e BIM, dashboard personalizzati o microservizi specifici per l'azienda - grazie all'MCP realizzerete tali interfacce rapidamente. In questo modo, i calcoli strutturali, l'analisi dei dati e l'automazione IA si fondono per la prima volta senza soluzione di continuità in un unico pipeline. Questo non è semplicemente un'altra funzione – è il salto in un'era ingegneristica rivoluzionaria e senza limiti, in cui le vostre idee diventano realtà più velocemente che mai.

Le richieste API sono tutte le azioni che apportano modifiche attive ai modelli, attivano calcoli, recuperano risultati o salvano modelli. Queste includono, ad esempio, modifiche ai modelli, esecuzioni di calcoli e query sui risultati. Le operazioni amministrative come le richieste di tipo "Servizio" (ad esempio, l'interrogazione dei dati di fatturazione correnti) non vengono conteggiate come richieste API.

Il numero di richieste API è rilevante per il tuo abbonamento API, poiché è disponibile una determinata quota di richieste per periodo di fatturazione a seconda dell'abbonamento selezionato.

Come utente attivo si considera ogni utilizzatore che esegue almeno una richiesta tramite l'API di Dlubal all'interno di un periodo di fatturazione. Non importa quanti chiavi API utilizzi un singolo utente - ogni utente viene conteggiato solo una volta durante un periodo di fatturazione.

Per monitorare in modo trasparente e chiaro l'utilizzo dell'API, ti consigliamo di creare chiavi API separate per singoli progetti o utenti. Questo ti permette di valutare l'utilizzo dell'API in modo preciso e individuale.

Dlubal attribuisce grande importanza alla fiducia e alla trasparenza. Pertanto, nel tuo account personale Dlubal Extranet, nella sezione "API & Cloud → API II", troverai tabelle dettagliate che ti permetteranno di monitorare chiaramente le tue richieste API, le sessioni API e il numero di richieste entro periodi di tempo definiti.

• Extranet Dlubal | API II | Richieste API | I miei
• Extranet Dlubal | API II | Conteggi di richieste API | Mio

Una documentazione API completa con descrizioni dettagliate dei metodi, esempi pratici e istruzioni chiare per l'installazione è disponibile sul nostro sito web:

Questa documentazione ti aiuta a familiarizzare rapidamente con l'API e a lavorare in modo produttivo con essa. La raccolta di esempi di codice viene continuamente ampliata e ottimizzata. Inoltre, stiamo attualmente sviluppando una piattaforma web-community in cui gli utenti di Dlubal possono scambiarsi attivamente esperienze e condividere consigli, domande e soluzioni.

Inoltre, offriamo numerosi webinar sul tema API in cui potrai conoscere le possibilità pratiche e ottenere preziose informazioni.

In caso di domande su installazione, connessione o messaggi di errore, troverete risposte e supporto nell'area Supporto e FAQ sul nostro sito web:

• Domande frequenti (FAQ)

Per richieste più dettagliate, esigenze individuali o supporto nello sviluppo, offriamo corsi di formazione e consulenze su misura.

Inoltre, presto sarà disponibile la nuova piattaforma della comunità Dlubal. Qui potrete scambiare idee con altri utenti, condividere esperienze e sviluppare soluzioni insieme. La comunità offre il vantaggio di un supporto rapido grazie alla conoscenza collettiva e alla comunicazione diretta.

La nostra assistente AI Mia è inoltre disponibile 24 ore su 24. È stata specificamente addestrata con le conoscenze dell'API Dlubal e può fornire soluzioni e informazioni appropriate in modo rapido e semplice in qualsiasi momento.

gRPC è una tecnologia di comunicazione moderna e aperta (open-source), sviluppata per processi di scambio dati particolarmente veloci e affidabili tra applicazioni. Un vantaggio essenziale di gRPC è l'elevata efficienza: la comunicazione gRPC può essere fino a 15 volte più veloce rispetto a tecnologie tradizionali come SOAP o REST.

Come utente, non è necessario avere conoscenze speciali su gRPC, poiché tutti i dettagli tecnici sono già integrati nei client forniti da Dlubal. Beneficiate automaticamente della velocità e dell'affidabilità della tecnologia gRPC.

La Unified API aumenta la vostra efficienza perché …

• Risparmia tempo – Automatizzate la costruzione del modello, l'assegnazione dei carichi e la valutazione dei risultati, riducendo notevolmente il vostro processo di dimensionamento.
• Riduce i costi – Meno passaggi manuali significano meno ore di ingegneria e quindi costi di progetto inferiori.
• Personalizzazione completa – Progettate calcoli, report e flussi di lavoro esattamente in base alle vostre specifiche di progetto o aziendali, senza essere limitati dalle restrizioni della UI.
• Integrazione senza soluzione di continuità – L'API collega RFEM, RSTAB & Co. in modo bidirezionale con strumenti BIM e CAD, evitando interruzioni di flusso e garantendo dati consistenti.
• Accesso completo ai dati – Accedete a tutti gli oggetti del modello e ai risultati, filtrate e elaborate ulteriormente i dati per prendere decisioni basate sui dati.
• Libera il potenziale per l'innovazione – Sviluppate nuove app, prototipi e flussi di lavoro AI (ad es. con l'assistente AI Mia), senza reinventare la ruota.
• Offre alte prestazioni – Grazie alla tecnologia gRPC, lo scambio di dati è fino a 10 volte più veloce rispetto ai classici servizi SOAP/REST.

Dlubal consiglia Visual Studio Code come ambiente di sviluppo (IDE) per la programmazione API. Visual Studio Code è versatile, gratuito e open source e si distingue per la sua completa estensibilità. È possibile installare numerose estensioni per rendere la programmazione ancora più efficiente, ad esempio l'estensione Cline AI per la programmazione intelligente assistita dall'intelligenza artificiale, che ottimizza ulteriormente il flusso di lavoro.

• Cline AI: l'AI collaborativa per la programmazione