# 使用 OpenAPI 規格與 RAML 定義

根據 OAS（原名為 Swagger）與 RAML 規格建立 API 定義。API 合約編輯器可讓您無需了解其複雜語法即可使用這些規格。從 API Contracts 中的單一 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 定義。