한줄평
“API 명세를 다루는 팀이 문서 일관성을 자동으로 지키기에 좋습니다. 다만 규칙을 직접 짜야 제 값을 하고, GUI 가 없어 초심자에게는 진입 장벽이 있습니다.”
이런 분께 API 명세 품질을 CI 에서 자동 검증하고 싶은 개발팀께
좋은 점
- OpenAPI·AsyncAPI 규칙 기본 내장
- 커스텀 규칙으로 팀 표준 강제 가능
아쉬운 점
- 규칙 설정 없이는 효용이 제한적이고 명령줄 사용에 익숙해야 함
스펙트럴 소개
JSON·YAML 문서를 정해둔 규칙(스타일 가이드)에 맞게 검사해 주는 명령줄 린터입니다. OpenAPI 3.1/3.0/2.0 과 AsyncAPI 2.x 규칙이 기본 내장되어 있어 API 명세를 자동으로 점검할 수 있습니다. 규칙을 직접 정의해 팀 표준을 강제하거나 CI 파이프라인에 붙여 커밋마다 명세 품질을 검증하는 용도로 씁니다. 콘솔에서 돌리는 개발 도구라 별도 화면은 없습니다.
