개요
OpenAPI 사양 파일에서 REST 클라이언트와 데이터 클래스를 자동으로 생성하는 Flutter/Dart 패키지입니다. OpenAPI(이전의 Swagger) 정의를 유형 안정적인 Dart 코드로 변환함으로써 API 통합을 간소화하고 빌더 플레이트를 줄이며 개발 속도를 향상시킵니다. 표준화된 API 계약을 사용하는 팀에게 이상적이며, Android, iOS, macOS, Windows, Linux 등 여러 플랫폼을 지원합니다. 생성된 코드는 API 문서와 클라이언트 구현 간의 일관성을 보장합니다.
사용 사례
- API 클라이언트 생성 자동화
- OpenAPI 사양과 클라이언트 코드 동기화
- 수동 JSON 직렬화 줄이기
- API를 활용한 빠른 프로토타이핑
- 플랫폼 간에 일관된 데이터 모델 유지
주요 기능
- OpenAPI 스키마에서 데이터 클래스 생성
- REST 클라이언트 인터페이스를 생성합니다
- 완전한 OpenAPI 사양을 지원합니다
- 타입 안전한 Dart 코드를 생성합니다
- CI/CD 파이프라인과 통합됩니다
적합한 대상
- OpenAPI 사양을 사용하는 팀
- 자동 API 클라이언트 생성이 필요한 프로젝트
- 보일러플레이트를 줄이려는 개발자
- 크로스플랫폼 모바일 및 데스크톱 앱
- API 중심 개발 워크플로우
고려 사항
- 유효한 OpenAPI 3.x 사양이 필요합니다
- 복잡한 스키마의 경우 수동 조정이 필요할 수 있습니다
- 생성된 코드는 버전 관리되어야 합니다
- 동적 또는 비표준 API에는 적합하지 않습니다
- API 문서 워크플로와 함께 사용하는 것이 가장 좋습니다