YAML
YAML(Yet Another Markup Language)是一种数据序列化格式,通常被用来配置文件。它易于阅读,并且以数据结构为中心。YAML文件通常以`.yaml`或`.yml`为扩展名。
下面是一个YAML文件的简单示例:定义了一个人的基本信息,包括姓名、年龄、婚姻状态以及孩子的列表。
# 这是一个注释
name: John Doe
age: 30
married: true
children:
- name: Jimmy
age: 5
- name: Jenny
age: 7
OpenAPI
OpenAPI(之前称为Swagger)是一种规范,用于描述、消费和可视化 RESTful web 服务。它提供了一种可读性强且易于理解的格式,可以让人和机器都能读懂。OpenAPI 规范允许开发人员设计、构建、记录和使用 RESTful 服务,同时还提供了可视化界面,方便测试和交互。
OpenAPI 规范定义了几个核心组件,包括:
- 概述(Info):提供有关 API 的基本信息,例如