소개

안녕하세요. Wano 주식회사 엔지니어의 nari라고 합니다.
갑자기, 여러분은 openAPI 사양 공유 도구에 무엇을 사용하고 있습니까?

Swagger 주변의 툴을 사용하고 있는 쪽이 많은 것이 아닐까 생각합니다.

그러나 프런트 측이나 비즈니스 측의 인간에게도 확인해 주고 싶거나 괴롭히고 싶은 경우, yml이나 json 베이스의 소스를 괴롭히는 것은 꽤 어려운 일도. .

거기서 현재는 GUI로 만지는 Apicurio라는 툴을 시험하고 있어, 꽤 우수했기 때문에 소개하겠습니다.
마지막 도구 선택 기사는 여기

Apicurio Studio란 무엇입니까?

Design beautiful, functional APIs with zero coding, using OpenAPI가 테마.
(https://www.apicur.io/에서 발췌)
Web Based, Code-optional Design을 특징으로 한 OSS입니다.

Apicurio Studio의 여기가 굉장하다

1. 기본 기능을 무료로 사용할 수 있는 플랫폼이다

OSS로 제공되며 기본 기능은 완전 무료로 사용할 수 있습니다.
다른 플랫폼 기반 도구가 기본적으로 한 멤버 평균 20달러 정도 걸린다고 생각하면 꽤 훌륭합니다. . (Swagger-hub가 달에 90달러(5멤버))

2. 소스 리포지토리와의 sync가 가능

현재 github, bitbucket, gitlab을 지원합니다.

콜라보 레이터도 초대 할 수 있으며 여러 사람이 관리 할 수 ​​있습니다.

3.GUI포치포치로 OpenAPI 사양을 만들 수 있다

다음과 같이 쿼리 매개 변수 및 페이로드 설정을 GUI로 설정할 수 있습니다 (자유 형식도 설정할 수 있음)

물론 직접 소스를 놀 수 있습니다.

4.Document의 UI가 예쁘다

다른 OpenAPI 도구와 마찬가지로 Document도 생성 할 수 있지만 UI가 매우 쉽습니다. (아래 이미지 참조)

각 api의 세부 사항과 예제를 한눈에 볼 수 있습니다.

Apicurio Studio의 약점

mockAPI를 생성할 수 없음

로드맵 | Apicurio Studio
에 따르면 미래에 할 수있는 것처럼 보이지만 현재는 할 수 없으므로 대체 물건을 사용해야합니다.
그 때, apisprout 의 docker 컨테이너를 자사 서버에 세워 두고, apicurio 로부터 토출한 openapi.yml 를 로드 시키면, 간단하게 mockAPI 를 세울 수 있어 추천입니다.

끝에

Swagger 일강이라고 생각되고 있습니다만, 솔직히 최종적으로 yml이 토해낼 수 있으면 뭐든지 좋기 때문에 GUI 툴인가를 검토해 봐도 좋을까라고 생각합니다.
그 밖에 이런 툴을 추천해, 등 있으면 꼭 가르쳐 주셨으면 합니다.