RAML by Example

RAML 101: Libraries and DataTypes Fragments

One of the great things about RAML is modularization. This gives the ability to…

Objects in query params

There is a debate over how objects should be represented in the “query” part of URIs.

Some people prefer JSON:

?foo={bar:0} # URL-encoded: ?foo=%7Bbar%3A0%7D

ramldt2jsonschema Quick Start (js2dt)

ramldt2jsonschema is both a CLI tool and a Library that can convert a RAML DataType to a JSON…

API Console version 6 is released

I am happy to announce new version of API Console is now available…

Conditional JSON properties (Part 1)

One of the most important aspect of designing Web APIs is modeling its data layer. The data…

Why use RAML data types?

I was recently asked: “Why should I use RAML data types when I can embed JSON schemas directly in my API definitions?”.

I thought providing a simple side-by-side example would speak for itself. As I was writing the example, I thought it would be worth sharing.