RAML by Example
Series of examples showcasing the power of RAML
API Console version 6 is released
API Console version 6 is released
I am happy to announce new version of API Console is now available in stable release. It brings multiple changes and new tooling. Read…
The future of SDKs for the web platform
The future of SDKs for the web platform
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…
Using RAML-For-JAX-RS for Brewing (Part II): Building a better model
Using RAML-For-JAX-RS for Brewing (Part II): Building a better model
Welcome back!
Conditional JSON properties (Part 2)
Conditional JSON properties (Part 2)
In Part 1, we covered several scenarios in which we defined sets of JSON properties that were either valid or invalid depending on the…
Conditional JSON properties (Part 1)
Conditional JSON properties (Part 1)
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 Quick Start
raml-javascript-generator Quick Start
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 Quick Start
raml-cop Quick Start
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…
Using RAML-For-JAX-RS for Brewing (Part I)
Using RAML-For-JAX-RS for Brewing (Part I)
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…
oas-raml-converter Quick Start
oas-raml-converter Quick Start
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 Quick Start
raml2html Quick Start
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 Quick Start (js2dt)
ramldt2jsonschema Quick Start (js2dt)
ramldt2jsonschema is both a CLI tool and a Library that can convert a RAML DataType to a JSON Schema, and vice-versa.
Requiring query params
Requiring query params
Sometimes we need to require specific query parameters in URLs. There are different ways to go about it in RAML.
ramldt2jsonschema v0.2.0 released 🎉
ramldt2jsonschema v0.2.0 released 🎉
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 released 🚀
osprey-mock-service v0.4.0 released 🚀
osprey-mock-service v0.4.0 introduces a single improvment, but it is more significant than it seems.
Quick mocks with osprey-mock-service
Quick mocks with osprey-mock-service
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.
Arrays in query params
Arrays in query params
The same way there is no concensus over how objects should be represented in query parameters, there is no standardized way to format…
Modeling amounts in RAML
Modeling amounts in RAML
In JSON, values must be one of the following data types:
osprey-mock-service v0.3.0 released 🚀
osprey-mock-service v0.3.0 released 🚀
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…