RAML

RAML - (RESTful API Modeling Language 即RESTful API建模语言)

• 易于阅读API
• 易于设计API
• 易于共享API
• 语法简洁明了
• 关注需要定义的信息即可
• 机器可解析并生成html文档

---

开发工具

• API Designer
• API Console`
• API Notebook`

摘要

RAML 是一种基于HTTP-API的定义语言. 体现了所有对象传输状态的原则 . RAML基于YAML ,符合1.2版本规范,能帮助设计 RESTful API 和鼓励 API的发掘和重用 , 依靠标准和最佳实践从而编写更高质量的API . 生成全面的用户文档 .

RAML通过一个格式来提供规范的接口.作为API提供者和使用者之间的合约.用户可使用文档实现客户端和服务器的交互.

组织结构

• 基本信息 解释了如何描述核心API的方面,如它的名称、标题、位置(URI)和违约。描述如何包含API的支持文档。
• 数据类型 描述了一种通过简化模型API数据类型系统,也包括JSON和XML模式。
• 资源 描述了如何指定一个API的资源和嵌套的资源,以及在任何URI URI参数模板。
• 方法 描述了如何指定API的资源上的方法,以及他们的请求头,查询参数和请求。
• 响应 描述API规范的反应,包括状态码、媒体类型,响应头和响应。
• 资源类型和特征 描述可选机制使用RAML资源类型和特征描述资源,避免不必要的重复在一个API的定义和促进一致性和重用。
• 安全 描述了机制中可用RAML指定一个API的安全方案。
• 注释 描述了扩展机制RAML规范通过定义强类型的注释和应用规范。
• Includes,Libraries 覆盖以及扩展 描述了一个API的定义可能是由外部化定义文件,如何打包成库集合的定义,如何分离和覆盖层的元数据的RAML文档,以及一个API规范与附加功能可以扩展。

连接 : RAML官方解释

目录

用 [TOC]来生成目录：