News / Technologie

RESTfull API Modeling Language oder kurz RAML ist eine YAML-basierte Sprache, die es erlaubt APIs auf einfache Weise zu designen, zu warten, wiederzuverwenden und zu teilen. Ihre nützlichste Funktion ist, dass sie nicht nur zur Beschreibung von APIs genutzt werden kann, sondern auch, um sie zu modellieren.

Um das Leben noch einfach zu machen, hat MuleSoft einige Werkzeuge entwickelt: den API Designer, die API Console, die API Workbench und das API Notebook. Man kann während der RAML API-Definition die Aufrufe testen. Das hilft sehr dabei die Wahrscheinlichkeit von Fehlern zu eliminieren.

Da RAML auf YAML basiert, ist die Sprache relativ gut für Leute ohne große technische Kenntnisse lesbar. Daher nutzen es Projektmanager genauso wie alle anderen, die ihre Syntax lernen.

Eine sehr nützliche Funktion von Anypoint Studio ist, dass man eine API-Spezifikation von RAML in sein Projekt importieren kann. Diese Spezifikationen können in RAML 0.8 oder RAML 1.0 geschrieben sein. Man kann aber auch OpenAPI-Spezifikationen (OAS) nutzen. Man kann Daten, Anhänge und Ressource-Typen, Security-Schemata, Eigenschaften, verschiedene Bibliotheken und sogar Antwort-Beispiele definieren.