RAML 是一种简单但功能强大的用于建模 API 的语法。它为 API 的快速开发提供了一种易于理解的方法，适用于从兴趣项目到企业应用的各种场景。通过命名 API、指定其版本和基础 URL，以及指定可重复使用的类型来避免重复和冗余，RAML 可以帮助您更好地构建 API。您可以使用它来建模端点，包括访问信息、HTTP 动词、参数、示例响应等，还可以在一个接口中对多种响应类型（如 JSON 和 XML）进行建模。
RAML 还具有许多其他优点。在设计 API 时，它允许您在不编写一行代码的情况下，通过易于阅读的纯文本来查看 API 的外观。您不仅可以完善 API 设计，还可以为客户、合作伙伴甚至自己的内部工程师创建一个功能齐全的模拟，以供他们审查和构建。
此外，RAML 使开发人员能够专注于编写代码。它减少了市场推广时间和因设计不一致而导致的问题。您可以使用许多工具从 RAML 文件中生成 API 的一般结构。
测试 API 也变得更加简单。通过运行一个简单的 shell 命令，RAML 可以为您生成大部分测试。您还可以使用第三方服务进行测试。
文档生成也变得轻松。RAML 可以轻松生成所有文档，为您提供最新的文档，只需点击一下按钮即可。
最后，RAML 有助于为用户提供更丰富的体验，包括通过 API Notebook 提供动态的演练示例、为最流行的语言提供 SDK 等。
