Découvrez l’API Dlubal

L’API Dlubal est une interface de programmation (Application Programming Interface) qui vous permet d’accéder directement aux fonctionnalités des logiciels Dlubal. Actuellement, l’API est disponible pour RFEM 6 et RSTAB 9, et sera également disponible à l’avenir pour RSECTION, RWIND et l’outil Geo-Zones.

Avec l’API Dlubal, vous pouvez automatiser efficacement des tâches répétitives et chronophages, créer des flux de travail sur mesure, et développer des solutions personnalisées pour des processus internes ainsi que des projets clients spécifiques. Les domaines d’application typiques comprennent, par exemple, la modélisation automatisée et la saisie des données, les études de variantes pour l'optimisation des constructions, des méthodes de dimensionnement et de vérification personnalisées, ou encore des interfaces avec d'autres solutions logicielles.

De plus, l’API vous permet de structurer vos flux de travail de manière flexible et indépendante de l’interface graphique des logiciels Dlubal. Vous pouvez créer vos propres scripts et programmes qui répondent exactement à vos besoins et s'intègrent parfaitement à vos processus existants.

Nous sommes heureux de vous conseiller individuellement sur vos exigences concrètes et de vous accompagner dans l’intégration de l’API dans votre processus de travail.

Pour utiliser l'API Dlubal, vous avez besoin d’une licence valide (version complète ou d’essai) d’un logiciel principal Dlubal pris en charge (actuellement RFEM 6 et RSTAB 9, à l’avenir également RSECTION, RWIND et Geo-Zone) ainsi qu’une clé API personnelle. Vous pouvez générer cette clé API facilement via votre compte extranet Dlubal sous "API & Cloud → API II → Mes clés API" :

Un abonnement API n’est pas obligatoire, vous pouvez directement commencer avec l’abonnement API gratuit « Free » et découvrir et utiliser l'API sans engagement.

La nouvelle API de Dlubal est basée sur la technologie moderne gRPC et prend actuellement en charge principalement Python. Vous pouvez installer très facilement le client Python officiel via PyPI. La documentation de l’API Dlubal propose de nombreux exemples de code pour vous aider à démarrer.

Un nouveau client C# a été ajouté, disponible commodément via NuGet.

Pour la plupart des cas d’utilisation, nous recommandons néanmoins Python. Le langage est facile à apprendre, permet un développement de prototypes extrêmement rapide, offre un vaste choix de bibliothèques et bénéficie d’une communauté particulièrement active.

La nouvelle API de Dlubal prend actuellement en charge RFEM 6, RSTAB 9 et RSECTION 1. À l’avenir, elle sera également disponible pour RWIND ainsi que pour l’outil de zones géographiques. Les licences complètes, les licences universitaires et étudiantes ainsi que les versions d’essai des logiciels sont compatibles. Le support des versions de démonstration est actuellement en préparation.

L’API Dlubal est régulièrement mise à jour avec les principaux programmes pris en charge (actuellement RFEM 6 et RSTAB 9, à l’avenir RSECTION et RWIND). Pour garantir une compatibilité optimale, nous vous recommandons d’utiliser toujours la version de l’API qui correspond au numéro mineur et de patch de votre programme principal installé. Exemple : la version 6.10.0007 de RFEM doit être utilisée avec la version 2.10.7 de l'API.

L’API est continuellement élargie et optimisée. Pour rester toujours à jour, nous vous recommandons de suivre régulièrement les rapports de mise à jour actuels dans la section « Versions » de la documentation officielle de l’API Dlubal.

Le futur Serveur MCP de Dlubal est actuellement en développement actif pour permettre un accès assisté par IA à toutes les données et fonctions de RFEM et RSTAB. Il agit comme un intermédiaire entre vos applications et les logiciels Dlubal RFEM ou RSTAB. Son concept repose sur trois piliers principaux :

1. Couche API ouverte – Des points d'accès REST et WebSocket bien documentés encapsulent toutes les fonctions de modèles, résultats et dimensionnements. Cela vous permet d’accéder à RFEM/RSTAB de manière totalement indépendante de la plateforme.

2. Bus de données en temps réel – Les modifications du modèle et toutes les données pertinentes RFEM/RSTAB – y compris les cas de charge, les efforts internes ou les résultats de dimensionnement – sont diffusées en temps réel. Ainsi, les systèmes externes peuvent y accéder immédiatement, lancer des calculs automatiquement ou déclencher d'autres actions.

3. Orchestration par IA – Un moteur IA intégré traduit automatiquement les entrées en langage naturel ou les tâches d'optimisation en requêtes API appropriées, un peu comme si vous adressiez vos commandes à un chatbot IA, comme notre assistante Mia. Quelques exemples :

• Créez une nouvelle barre entre les nœuds 5 et 8 en acier S235 avec une section IPE 200.
• Donnez-moi tous les efforts internes de la barre 12 pour le cas de charge 5.
• Identifiez la barre la plus critique dans le modèle.
• Trouvez la section la plus sollicitée de la série HE-A pour la barre 21.
• Importez le fichier DXF xxxxx.dxf en tant que calque d'arrière-plan.
• Modélisez une salle 3D avec les paramètres suivants : largeur, hauteur, profondeur, inclinaison du toit, …

Toutes ces instructions sont ensuite exécutées automatiquement sur votre modèle par le serveur MCP.

En bref, le futur serveur MCP de Dlubal deviendra le centre névralgique d'un nouveau monde de calcul structurel, ouvert et interconnecté. Derrière se trouve le Protocole de Contexte de Modèle (MCP), une norme ouverte pour coupler des modèles IA avec des outils externes et des sources de données. Cela permet de connecter RFEM ou RSTAB à presque toute application avec seulement quelques lignes de code. Que ce soit pour les logiciels CAO et BIM, les tableaux de bord personnalisés ou les microservices spécifiques à l'entreprise - grâce au MCP, vous réalisez ces interfaces en un rien de temps. Ainsi, les calculs structurels, l'analyse de données et l'automatisation IA se fondent pour la première fois de manière transparente dans une seule et unique pipeline. Ce n'est pas simplement une nouvelle fonctionnalité – c'est le saut vers une ère d'ingénierie révolutionnaire et sans limites, où vos idées deviennent réalité plus rapidement que jamais.

Les demandes API incluent toutes les actions qui effectuent activement des modifications sur les modèles, lancent des calculs, récupèrent des résultats ou enregistrent des modèles. Cela comprend, par exemple, les modifications de modèles, les exécutions de calculs et les récupérations de résultats. Les opérations administratives telles que les requêtes de type d’opération « Service » (par exemple la récupération des données de facturation actuelles) ne sont pas comptabilisées comme des demandes API.

Le nombre de demandes API est pertinent pour votre abonnement API, car selon l’abonnement choisi, un certain quota est disponible par période de facturation.

En tant qu’utilisateur actif, chaque utilisateur qui effectue au moins une demande via l’API Dlubal au cours d'une période de facturation est comptabilisé. Peu importe le nombre de clés API qu’un utilisateur utilise, chaque utilisateur n’est compté qu’une seule fois au cours d’une période de facturation.

Pour surveiller l’utilisation de l’API de manière transparente et claire, nous vous recommandons de créer des clés API distinctes pour des projets ou des utilisateurs individuels. Cela vous permet une évaluation précise et individuelle de l'utilisation de l'API.

Dlubal accorde une grande importance à la confiance et à la transparence. Vous trouverez donc dans votre compte personnel Dlubal-Extranet, dans la section « API & Cloud → API II », des tableaux clairs dans lesquels vous pouvez suivre vos demandes API, vos sessions API ainsi que le nombre de requêtes sur des périodes définies.

• Extranet Dlubal | API II | Requêtes API | Mon
• Extranet Dlubal | API II | Requêtes API | Mon

Une documentation API complète avec des descriptions détaillées des méthodes, des exemples d’application pratiques et des instructions d’installation claires est disponible sur notre site Web :

Cette documentation vous aide à vous familiariser rapidement avec l’API et à travailler de manière productive avec elle. La collection d’exemples de code est continuellement élargie et optimisée. De plus, nous développons actuellement une plateforme communautaire Web où les utilisateurs de Dlubal peuvent échanger activement leurs expériences et partager des conseils, des questions et des solutions.

Nous proposons également de nombreux webinaires sur le thème de l'API, dans lesquels vous pouvez découvrir les applications pratiques et obtenir des aperçus précieux.

Pour toute question concernant l’installation, la connexion ou des messages d’erreur, vous trouverez des réponses et de l’aide dans la section Support et FAQ sur notre site web :

• FAQ

Pour des demandes plus importantes, des exigences individuelles ou un soutien au développement, nous vous proposons des formations et des consultations sur mesure.

De plus, notre nouvelle plateforme communautaire Dlubal sera bientôt disponible. Vous pourrez y échanger avec d’autres utilisateurs, partager des expériences et développer ensemble des solutions. La communauté offre l’avantage d’un soutien rapide grâce à la connaissance collective et à la communication directe.

Notre assistante IA Mia est également disponible 24 heures sur 24. Elle a été spécialement formée avec des connaissances sur l'API Dlubal et peut fournir à tout moment des solutions et des informations adéquates rapidement et facilement.

gRPC est une technologie de communication moderne et ouverte (Open Source) conçue pour des processus d’échange de données particulièrement rapides et fiables entre applications. Un avantage majeur de gRPC est sa grande efficacité : la communication gRPC peut être jusqu’à 15 fois plus rapide que les technologies traditionnelles comme SOAP ou REST.

En tant qu’utilisateur, vous n’avez pas besoin de connaissances spécifiques sur gRPC, car tous les détails techniques sont déjà intégrés dans les clients fournis par Dlubal. Vous bénéficiez automatiquement de la rapidité et de la fiabilité de la technologie gRPC.

L'API unifiée augmente votre efficacité, car vous...

• Gagnez du temps – Automatisez la création de modèles, l’application des charges et l’évaluation des résultats, ce qui raccourcit considérablement vos processus de vérification.
• Réduisez les coûts – Moins d'étapes manuelles signifient moins d’heures d’ingénierie et donc des coûts de projet réduits.
• Personnalisation totale – Concevez vos calculs, rapports et flux de travail exactement selon les exigences de votre projet ou de votre entreprise, sans être limité par les contraintes de l’interface graphique.
• Intégration transparente – L’API connecte RFEM, RSTAB, etc,. de manière bidirectionnelle avec les outils BIM et CAO, élimine les ruptures de médias et assure la cohérence des données.
• Accès étendu aux données – Accédez à tous les objets de modèle et résultats, filtrez de manière ciblée et continuez à traiter les données pour prendre des décisions basées sur les données.
• Libère le potentiel d’innovation – Développez de nouvelles applications, prototypes et workflows d'IA (par exemple avec l'assistante IA Mia), sans réinventer la roue.
• Offre une haute performance – Grâce à la technologie gRPC, l'échange de données est jusqu'à 10 fois plus rapide que les services classiques SOAP/REST.

Dlubal recommande Visual Studio Code comme environnement de développement pour la programmation API. Visual Studio Code est polyvalent, gratuit et open source, et se distingue surtout par sa grande extensibilité. Vous pouvez installer de nombreuses extensions pour rendre votre programmation encore plus efficace, par exemple, l’extension Cline AI pour une programmation intelligente assistée par l’IA, qui optimise également votre flux de travail.

• Cline AI : Le codeur IA collaboratif