BT

InfoQ Homepage News The RAML Workgroup Announces RAML 1.0 and API Workbench

The RAML Workgroup Announces RAML 1.0 and API Workbench

This item in chinese

Bookmarks

The RAML community has announced the release of RAML 1.0, API Workbench and a JavaScript plus a Java RAML parser.

RAML 1.0 is a Release Candidate but it is close to final, the last touches being done this month. The Specification defines the language and its features. Compared to 0.8, the new features are:

  • Data types – the ability to describe the data. It supports built-in types –string, number, integer, boolean, date, file - or inherited ones. It understands enums, arrays, maps, unions, and complex data types can be built based on these.
  • Libraries – the ability to include predefined resources, data types, assets, and others, using namespaces
  • Overlays – including descriptions, annotations, and examples from other RAML files
  • Annotations – supporting third-party metadata beyond what’s specified in RAML 1.0
  • Improved security schemas

RAML 1.0 is accompanied by an Atom-based IDE called API Workbench. The IDE can be used to design, build, test, document and share APIs defined with RAML. It works both with RAML 0.8 and 1.0. API Workbench supports code completion, suggesting keywords, references, paths, common values, type properties, etc. The IDE performs automatic validation at several levels: structure, reference, resource, schema, or line. New elements can be created with the help of wizards.

MuleSoft has also contributed two parsers, one for JavaScript/TypeScript and another for Java. They are currently in beta. Other parsers including – .NET, Go, JavaScript, PHP, Python, Ruby, Scala – and other tools can be found at various stages at development in the RAML Projects Library.

RAML is being backed by a number of vendors involved in the creation, utilization and management of APIs, such as AWS, CA Technologies, Cisco, Software AG, VMware, and, of course, MuleSoft.

Rate this Article

Adoption
Style

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Community comments

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

BT

Is your profile up-to-date? Please take a moment to review and update.

Note: If updating/changing your email, a validation request will be sent

Company name:
Company role:
Company size:
Country/Zone:
State/Province/Region:
You will be sent an email to validate the new email address. This pop-up will close itself in a few moments.