1.2 KiB
title, ring, quadrant
| title | ring | quadrant |
|---|---|---|
| RAML | adopt | tools |
RAML (the RESTful API Modelling Language) is a YAML-based API specification language. It's now available in version 1.0. The philosophy behind it is to specify the API before implementation.
If you follow this philosophy, you can design your API and discuss it with your clients and team before implementing a single line of code. API consumers are able to implement against the API before it's really up and running. The api-console provides a beautiful online documentation with "try it" features for your raml definition.
The RAML ecosystem provides a rich toolset for code generation (e.g. online editor; api-workbench), automatically generated documentation, code generation (e.g. go-raml), mocking, testing and much more. We prefer RAML over Swagger because of this.