OpenAPI 3.0으로 변환하는 웹 서비스들 소개

1. 온라인 변환기 웹 서비스

공식적으로 제공되는 Swagger Converter 웹사이트(converter.swagger.io)에서 Swagger 2.0(OpenAPI 2.0) 사양을 OpenAPI 3.0 사양으로 변환할 수 있습니다.
웹 인터페이스에서 파일을 업로드하거나 URL을 입력하면 변환된 OpenAPI 3.0 문서를 바로 받을 수 있습니다.
Docker 이미지로도 제공되어 자체 서버에서 실행할 수도 있습니다.

사용 예시:

docker pull swaggerapi/swagger-converter:v1.0.2
docker run -it -p 8080:8080 --name swagger-converter swaggerapi/swagger-converter:v1.0.2

APIDog
- APIDog 웹 서비스에서는 Postman 컬렉션을 OpenAPI 3.0 형식으로 변환할 수 있습니다.
- Postman 컬렉션 파일을 업로드하고, 변환 후 OpenAPI 3.0 문서로 내보낼 수 있습니다.
- API 테스트, 모의 서버, 문서화 등 다양한 부가 기능도 제공합니다.
postman-to-openapi npm 패키지
- Node.js 환경에서 postman-to-openapi 패키지를 사용해 Postman 컬렉션을 OpenAPI 3.0 문서로 변환할 수 있습니다.
- 예시 코드:
```
const postmanToOpenApi = require('postman-to-openapi')
const postmanCollection = './path/to/your/collection.json'
const outputFile = './output/openapi.yml'
postmanToOpenApi(postmanCollection, outputFile, { defaultTag: 'General' })
```
- 이 방식은 자동화나 개발 파이프라인에 적합합니다.
Postman 공식 API
- Postman에서 제공하는 API를 통해 컬렉션을 OpenAPI 3.0으로 변환할 수 있습니다.
- API 키를 발급받아 변환 요청을 보내면 OpenAPI 3.0 문서를 받을 수 있습니다.
기타 온라인 변환 도구

AWS API Gateway
- OpenAPI 3.0 정의 파일을 직접 업로드하여 HTTP API를 생성할 수 있습니다.
- 기존 REST API를 OpenAPI 3.0 정의로 내보낸 뒤, 이를 API Gateway에 가져와 사용할 수 있습니다.
Salesforce, IBM API Connect 등

Salesforce, IBM API Connect와 같은 다양한 클라우드 서비스 및 API 관리 플랫폼에서도 OpenAPI 3.0 정의 등록 및 변환을 지원합니다.