RAML by Example

Recently at Chrome Dev Summit Gray Norton was talking about new proposal to web platform: the Layered APIs. It was a great talk about how…

Welcome back!

In Part 1, we covered several scenarios in which we defined sets of JSON properties that were either valid or invalid depending on the…

One of the most important aspect of designing Web APIs is modeling its data layer. The data layer can take different shapes and it can be…

raml-javascript-generator is a tool that generates JavaScript API clients from RAML API definitions. It takes a RAML file as input and…

raml-cop is a command-line tool for validating RAML files. It supports both RAML 0.8 and 1.0. It can validate included files as well as…

This is a tutorial on how to use raml-for-jaxrs to develop a real-life application. We will try to cover every aspect of application…

This is an introduction to oas-raml-converter. oas-raml-converter is a command line tool that helps convert to and from RAML and OAS.

raml2html is a documentation generator for RAML. It supports RAML 1.0. It provides both a CLI and a NodeJS library. It also supports custom…

ramldt2jsonschema is both a CLI tool and a Library that can convert a RAML DataType to a JSON Schema, and vice-versa.

Sometimes we need to require specific query parameters in URLs. There are different ways to go about it in RAML.

If your workflow involves the use of JSON Schema to describe the payloads of your api, and ramldt2jsonschema's js2dt command to convert…

osprey-mock-service v0.4.0 introduces a single improvment, but it is more significant than it seems.

Perhaps the quickest way to turn a RAML file into a local mock service is to use osprey-mock-service. It’s simple to get started.

The same way there is no concensus over how objects should be represented in query parameters, there is no standardized way to format…

In JSON, values must be one of the following data types:

A new version of osprey-mock-service -- v0.3.0 -- has been released today. This is a summary of the new features and improvments included…

A new version of Osprey — v0.5.0 — has been released today.

In v0.1.3 of ramldt2jsonschema(release notes), JSON documents are now processed into more concise RAML documents.