De nieuwe API II van Dlubal Software is nu beschikbaar


De nieuwe API II van Dlubal Software is nu beschikbaar, wat betekent dit nu voor u of uw organisatie, als u een bestaand Webservice | API 1 subscriptie abonnement heeft?


API 1 en API 2

De webservice | API 1 is al een tijd beschikbaar en ontwikkeld op basis van de SOAP technologie. (Uitleg SOAP technologie) Na de implementatie van deze technologie in RFEM 6, RSECTION 1 en RSTAB 9 bleek, dat de technologie niet in alle gevallen helemaal aansloot bij de wensen van de gebruikers/applicatie ontwikkelaars. De overdracht van gegevens was met name te langzaam. 


Om deze reden is er een opvolger gekozen voor de Webservice | API 1, namelijk de API 2 op basis van de gRPC technologie (Uitleg gRPC en https://www.dlubal.com/en/support-and-learning/support/knowledge-base/001921). Met deze technologie is de overdracht van gegevens soms 10x sneller dan de oude API 1. 


Overstappen of niet?

Er is door het management van Dlubal Software het volgende besloten omtrent uw API 1 abonnement: 


  • Alle functionaliteiten blijven voorlopig werken en ondersteund via updates van RFEM 6 | RSTAB 9 | RSECTION 1. 
  • Echter zal er geen nieuwe ontwikkeling meer plaatsvinden voor de Webservice | API 1.
  • U kunt uw bestaande API 1 | Webservice abonnement blijven verlengen, indien u lopende projecten heeft. De software zal blijven werken. 
  • Er is geen mogelijkheid om automatisch over te stappen van de API 1 naar API 2. Voor de API 2 zal een nieuw abonnement dienen te worden afgesloten. 


Wij begrijpen dat dit mogelijk vervelend voor uw organisatie is, maar het was beter voor de Dlubal API gemeenschap om nu nog over te stappen naar een nieuwe technologie, die u en uw organisatie ook in de toekomst betere resultaten geeft.


De nieuwe API 2

Wij adviseren u om de mogelijkheden van de API 2 te onderzoeken.  De API 2 is gebaseerd op een High Level Library van Python en .Net (C#). Op dit moment is er geen C++ High Level Library. Alle ontwikkeling m.b.t. de API vindt enkel nog plaats in de API 2. Voor een volledige en meest up-to-date uitleg zie: https://www.dlubal.com/en/solutions/dlubal-api/api-documentation/index.


De API 2 is gebaseerd op een API Request prijsmodel. Voor een uitleg over de welke diverse API requests er zijn, zie: de API Referentie (https://www.dlubal.com/en/solutions/dlubal-api/api-documentation/api_applications)




Voorbeeld API request:


De volgende code is slechts één request. De methode 'rfem_app.create_object_list' zorgt voor een interactie met de RFEM 6 applicatie. De andere zaken zijn slechts 'objecten'.


Er is een viertal betaalde abonnementen: zie ook: https://www.dlubal.com/en/solutions/dlubal-api/api-documentation/subscriptions_and_pricing.


Er is een abonnement voor applicatie ontwikkelaars, deze is gratis en gebaseerd op een beperkt aantal API requests per maand.


De ADMIN van uw bedrijf kan via het Extranet account het aantal API requests voor u en uw organisatie goed in te gaten houden:



Aanvullende vragen:


1) Waarom is de backend door Dlubal Software op zo'n manier aangepast dat de API 1 op basis van SOAP gewoon werkt op gRPC? 


API 1 blijft volledig operationeel wanneer de optie 'Webservice' is geactiveerd in de globale instellingen van RFEM. We hebben geen bestaande functionaliteiten verwijderd of uitgeschakeld. We hopen echter op begrip van de gebruiker dat we geen interne strategieën of gedetailleerde beweegredenen achter onze beslissingen kunnen onthullen.


2) Waarom zijn de omschrijvingen van de 'Dockscripts' in Python voor de API 2 niet werkzaam zoals in de API 1?


Met betrekking tot de vermelding van "dock scripts" is het mogelijk dat de gebruiker eigenlijk doelt op "docstrings". Door ons proces voor clientgeneratie via gRPC en 'protobuf' zijn de huidige docstrings inderdaad minder gedetailleerd. Onze primaire focus lag op het behouden van hoogwaardige documentatie op onze website. We staan echter open voor het evalueren van mogelijkheden om de docstrings aan de clientzijde te verbeteren en zo de gebruikerservaring in de toekomst te optimaliseren.


3) Wat gebeurt er precies met de modellen die zijn gebruikt in de CloudComputing? Worden deze automatisch verwijderd?


Het model wordt na 14 dagen automatisch verwijderd. In deze periode heeft de gebruiker de mogelijkheid om het berekende model te downloaden.