Descubra a API Dlubal

A API Dlubal é uma interface programável (Application Programming Interface) que permite aceder diretamente a funções dos programas da Dlubal. Atualmente, a API está disponível para o RFEM 6 e o RSTAB 9 e futuramente estará também disponível para o RSECTION, o RWIND e a ferramenta Geo-Zone Tool.

Com a API Dlubal, pode automatizar de forma eficiente tarefas repetitivas e que consomem muito tempo, criar fluxos de trabalho personalizados e desenvolver soluções individuais para processos internos e projetos específicos de clientes. As áreas típicas de aplicação incluem, por exemplo, a modelação automatizada e a entrada de dados, estudos de variantes para otimização de construções, procedimentos de dimensionamento e verificação personalizados, ou também interfaces para outras soluções de software.

Além disso, a API permite-lhe desenhar os seus fluxos de trabalho de forma flexível e independente da interface de utilizador do software Dlubal. Pode criar os seus próprios scripts e programas que atendam exatamente às suas necessidades e se integrem perfeitamente nos seus processos existentes.

Teremos todo o prazer em aconselhá-lo de forma individual sobre os seus requisitos específicos e apoiá-lo na integração da API no seu processo de trabalho.

Para utilizar a API Dlubal, precisa de uma licença válida (versão completa ou de teste) de um programa principal da Dlubal suportado (atualmente RFEM 6 e RSTAB 9, futuramente também RSECTION, RWIND e Geo-Zone Tool), bem como uma chave API pessoal. Pode gerar esta chave API facilmente através de sua conta na extranet da Dlubal em "API & Cloud → API II → My API Keys":

Não é obrigatória uma assinatura da API – pode começar diretamente com a assinatura gratuita da API "Free" para conhecer e utilizar a API sem compromisso.

A nova API Dlubal baseia-se na moderna tecnologia gRPC e atualmente suporta sobretudo a Python. Pode instalar o Python-Client oficial de maneira muito simples através de PyPI. Na documentação da API Dlubal, estão disponíveis vários exemplos de código que facilitam o início.

Foi adicionado um novo C#-Client que está convenientemente disponível via NuGet.

Para a maioria dos casos de aplicação, ainda recomendamos a Python. A linguagem é fácil de aprender, permite um desenvolvimento de protótipos extremamente rápido, oferece uma enorme variedade de bibliotecas e beneficia de uma comunidade especialmente ativa.

A nova API Dlubal atualmente suporta os programas RFEM 6, RSTAB 9 e RSECTION 1. No futuro, também estará disponível para o RWIND e a Geo-Zone Tool. São compatíveis licenças completas do programa, licenças académicas e para estudantes, bem como versões de teste. O suporte para versões de demonstração está atualmente em preparação.

A API Dlubal é atualizada regularmente em conjunto com os programas principais suportados (atualmente RFEM 6 e RSTAB 9, futuramente RSECTION e RWIND). Para garantir uma compatibilidade ideal, recomendamos que utilize sempre a versão da API que corresponde ao número menor e de patch do seu programa principal instalado. Exemplo: a versão RFEM 6.10.0007 deve ser utilizada com a versão da API 2.10.7.

A API está continuamente a ser expandida e otimizada. Para estar sempre atualizado, recomendamos que acompanhe regularmente os relatórios de atualização atuais na secção "Releases" da documentação oficial da API Dlubal.

O futuro servidor MCP da Dlubal está atualmente em desenvolvimento para permitir um acesso suportado por IA a todos os dados e funções do RFEM e RSTAB. Atua como um intermediário entre as suas aplicações e os programas Dlubal RFEM ou RSTAB. O seu conceito assenta em três componentes principais:

1. Camada de API aberta – Endpoints REST e WebSocket claramente documentados encapsulam todas as funções de modelo, resultados e dimensionamento. Isso permite um acesso ao RFEM/RSTAB totalmente independente de plataforma.

2. Barramento de dados em tempo real – Mudanças no modelo e todos os dados relevantes do RFEM/RSTAB – incluindo casos de carga, esforços internos ou resultados de dimensionamento – são transmitidos em tempo real. Desta forma, os sistemas externos podem aceder imediatamente aos mesmos, iniciar cálculos automaticamente ou acionar outras ações.

3. Orquestração de IA – Um motor de IA integrado traduz entradas de linguagem natural ou tarefas de otimização automaticamente em requisições de API apropriadas – como se estivesse a direcionar os seus comandos a um chatbot de IA como a nossa assistente Mia. Exemplos disso são:

• Crie uma nova barra de aço S235 com a secção IPE 200 entre os nós 5 e 8.
• Forneça-me todos os esforços internos da barra 12 no caso de carga 5.
• Dê-me a barra mais crítica no modelo.
• Encontre a secção mais utilizada da série de perfis HE-A para a barra 21.
• Importe o ficheiro DXF xxxxx.dxf como uma camada de fundo.
• Modele um pavilhão 3D com os seguintes parâmetros: largura, altura, profundidade, inclinação do telhado, ...

Todas estas instruções são depois implementadas automaticamente no seu modelo pelo servidor MCP.

Em resumo: o futuro servidor MCP da Dlubal vai ser o centro nevrálgico de um novo mundo de análise estática de rede aberta. Por trás disso está o Model Context Protocol (MCP), uma padrão aberto para acoplar modelos de IA com ferramentas e fontes de dados externas. Assim, o RFEM ou RSTAB pode ser ligado no futuro com apenas algumas linhas de código a qualquer aplicação desejada. Seja software CAD e BIM, dashboards personalizados ou microsserviços específicos da empresa – com a ajuda do MCP, realiza tais interfaces num piscar de olhos. Desta forma, os cálculos estáticos, as análise de dados e a automatização de IA fundem-se pela primeira vez de maneira perfeita num único pipeline. Isto não é apenas mais uma função – é o salto para uma era de engenharia revolucionária e ilimitada, onde as suas ideias se tornam realidade mais rápido do que nunca.

Consideram-se pedidos API todas as ações que ativamente façam alterações em modelos, iniciem cálculos, recuperem resultados ou guardem modelos. Isso inclui, por exemplo, modificações de modelos, execuções de cálculos e consultas de resultados. Operações administrativas, como pedidos de operação do tipo "Serviço" (por exemplo, a consulta de dados de faturação atuais) não são contadas como pedidos API.

O número de pedidos API é relevante para a assinatura da sua API, porque, dependendo da assinatura escolhida, está disponível um determinado contingente de pedidos por período de faturação.

Como utilizador ativo é definido como cada utilizador que faz pelo menos uma solicitação através da API Dlubal dentro de um período de faturação. Não importa quantas chaves API um utilizador utiliza – cada utilizador é contado apenas uma vez dentro de um período de faturação.

Para monitorizar a utilização da API de forma transparente e clara, recomendamos que crie chaves de API separadas para projetos ou utilizadores individuais. Isso permite uma avaliação precisa e individual da utilização da API.

A Dlubal valoriza a confiança e a transparência. Portanto, encontrará na sua conta pessoal na extranet da Dlubal, na secção "API & Cloud → API II", tabelas claras onde pode acompanhar as consultas da API, as sessões da API e o número de consultas dentro de períodos definidos.

• Extranet Dlubal | API II | Pedidos de API | Meu
• Extranet da Dlubal | Interface de Programação de Aplicações II | Contagens de pedidos de API | O meu

Uma documentação API abrangente com descrições detalhadas de métodos, exemplos práticos de aplicação e instruções claras de instalação pode ser encontrada na nossa página web:

Esta documentação ajuda-o a familiarizar-se rapidamente com a API e a trabalhar produtivamente com a mesma. A coleção de exemplos de código está a ser continuamente expandida e otimizada. Além disso, estamos atualmente a desenvolver uma plataforma da comunidade na web, onde os utilizadores da Dlubal podem trocar experiências ativamente e partilhar dicas, perguntas e soluções entre si.

Também oferecemos vários seminários web sobre a API, onde pode aprender sobre as possibilidades práticas de utilização e obter informações valiosas.

Para perguntas relacionadas com a instalação, a ligação ou mensagens de erro, encontra respostas e assistência na secção de apoio e das perguntas mais frequentes da nossa página web:

• Perguntas mais frequentes (FAQ)

Para consultas mais extensas, requisitos individuais ou apoio ao desenvolvimento, oferecemos formações e consultorias personalizadas.

Em breve, a nova plataforma da comunidade Dlubal estará disponível para si. Aí, poderá interagir com outros utilizadores, partilhar experiências e desenvolver soluções em conjunto. A comunidade oferece a vantagem de apoio rápido através do conhecimento coletivo e da comunicação direta.

Além disso, a nossa assistente de IA Mia está disponível 24 horas por dia. Foi treinada especificamente com conhecimento sobre a API Dlubal e pode fornecer soluções e informações adequadas de forma rápida e descomplicada a qualquer momento.

O gRPC é uma tecnologia de comunicação moderna e aberta (código aberto) que foi desenvolvida para processos de troca de dados especialmente rápidos e confiáveis entre aplicações. Uma vantagem essencial do gRPC é a elevada eficiência – a comunicação gRPC pode ser até 15 vezes mais rápida do que tecnologias tradicionais como SOAP ou REST.

Como utilizador, não necessita de conhecimentos especiais sobre gRPC, porque todos os detalhes técnicos já se encontram integrados nos clientes fornecidos pela Dlubal. Você beneficia automaticamente da velocidade e confiabilidade da tecnologia gRPC.

A API unificada aumenta a sua eficiência, porque …

• Economiza tempo – Automatize a construção de modelos, a atribuição de cargas e a avaliação de resultados, reduzindo significativamente o processo de dimensionamento.
• Reduz custos – Menos etapas manuais significam menos horas de engenharia e, portanto, custos de projeto mais baixos.
• Totalmente personalizável – Configure cálculos, relatórios e fluxos de trabalho exatamente de acordo com as especificações do projeto ou da empresa, sem limitações de interface de utilizador.
• Integrado perfeitamente – A API liga bidirecionalmente o RFEM, RSTAB etc., com ferramentas BIM e CAD, evitando quebras de média e garantindo dados consistentes.
• Acesso abrangente a dados – Aceda a todos os objetos e resultados do modelo, filtre de maneira direcionada e processe dados para tomar decisões baseadas em dados.
• Liberta potencial de inovação – Desenvolva novas aplicações, protótipos e fluxos de trabalho de IA (por exemplo, com a assistente de IA Mia), sem reinventar a roda.
• Oferece alto desempenho – Graças à tecnologia gRPC, a troca de dados é até 10 vezes mais rápida do que com serviços SOAP/REST clássicos.

A Dlubal recomenda o Visual Studio Code como ambiente de desenvolvimento (IDE) para programação de API. O Visual Studio Code é versátil, gratuito e de código aberto, destacando-se particularmente pela sua extensibilidade abrangente. Pode instalar numerosas extensões para tornar a sua programação ainda mais eficiente, por exemplo, a extensão Cline AI para programação inteligente com suporte de IA, que otimiza ainda mais o seu fluxo de trabalho.

• Cline AI: codificador colaborativo de IA