A simple but powerful syntax for modelling APIs
RAML enables rapid development of APIs using an approachable syntax
which can scale from hobby project to enterprise application
Name your API, specify its version and base URL
Specify reusable types to avoid duplication and redundancy
Model your endpoints with access information, HTTP verbs, parameters, example responses and more
Model multiple response types including JSON & XML within a single interface
Design Your API
RAML lets you see what your API looks like as you design it, using easy to read plain text. Without having to write a single line of code you can not only perfect your API design, but also create a fully functional mock for customers, partners, or even your own internal engineers to review and build off of.
Learn MoreBuild Your API
RAML enables developers and engineers to do what they do best – write code. No more guesswork or getting halfway through your API only to realize the design doesn’t work or is inconsistent. You can also reduce your time to market (and bug based headaches) by using the many tools available to help you generate the general structure of your API from your RAML files.
Learn MoreTest Your API
Most engineers hate writing unit tests. RAML lets you generate a majority of the tests by running a simple shell command. No more manual tests (although we certainly recommend creating your own), and even better – you can even use third party services such as API Fortress, API Science, Parasoft, Postman, and SmartBear for your testing needs.
Learn MoreDocument Your REST API
Say goodbye to spending hours writing and maintaining API documentation. With RAML all of your documentation can be easily generated, letting you provide up-to-date documentation, all at the click of a button.
Learn MoreShare & Support Your API
What good is an API if nobody is using it? RAML helps you provide an even richer experience to your users, including dynamic walk-through examples with the API Notebook, SDKs for the most popular languages, and more.
Learn MoreHundreds of Open Source Projects
RAML is backed by a large open source community providing hundreds of pre-built, customizable tools for all your RESTful API needs
There are many advantages to taking an API-first development approach. And with the help of tools like RAML, APIs have become more elastic and easier to use.
Jerry Weng
Co-founder, CHOCOLABS