# 使用 OpenAPI 规范和 RAML 定义

根据 OAS（以前称为 Swagger）和 RAML 规范创建 API 定义。API 契约编辑器让您无需了解其复杂的语法即可使用这些规范。通过 API 契约中的单个 API 设计，您可以导出所有类型的 API 定义。

## 导入现有 API 定义

如果您已有现有的 API 定义，API Contracts 允许您导入以下格式：

* OpenAPI 规范 3.0
* OAS/Swagger 2.0
* Availability-note[Deprecated](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

  此内容已弃用。

  OAS/Swagger 1.2
* RAML 1.0

## 导出已完成的 API

完成 API 设计后，您可以通过 导出 菜单直接将 OAS/Swagger 或 RAML 下载到文件中。您还可以导出带有 Talend 扩展的 API 定义。