Eine RAML-Spezifikation importieren

Importieren

Datei ▸ Importieren (Ctrl+I), dann die .raml-Datei. Die Versionen RAML 0.8 und RAML 1.0 werden erkannt.

Was importiert wird

Element	Was Restorm daraus macht
Der Ressourcenbaum	Verschachtelte Ordner
Jede Methode	Eine HTTP-Anfrage
Die Parameter	Typisiert (Zeichenkette, Zahl, Enumeration …)
Die Typen und die Dokumentation	Die API-Dokumentation

Sicherheit

Nur Basic und OAuth 2.0 verdrahten vorab einen Header Authorization. Die übrigen Schemata (Digest, Pass Through, OAuth 1.0, Schemata x-*) sind nur dokumentiert.

Einschränkungen

!include wird abgelehnt

Ein !include <path> oder ein !include <url> lässt den Import fehlschlagen, mit einer expliziten Meldung. Das ist beabsichtigt: Ein Include aufzulösen bedeutet, eine beliebige Datei der Festplatte zu lesen oder im Namen des Benutzers einen Netzwerkaufruf auszulösen.

Lösen Sie Ihre Includes vorab auf (erzeugen Sie ein flaches RAML) und importieren Sie dann.

Weitere Einschränkungen: Verweise auf externe Typen werden nicht aufgelöst, und die Bibliotheken uses: bzw. RAML-Fragmente werden nicht zusammengeführt.