Kiota

Kiota는 마이크로소프트(Microsoft)에서 만든 오픈소스 코드 생성기로, OpenAPI 명세서(OpenAPI Specification) 를 기반으로 타입 세이프(Type-safe) 한 API 클라이언트 코드를 자동으로 생성해줌

한 줄 요약

Kiota는 OpenAPI 명세서에서 API 클라이언트 코드를 자동으로 생성해주는 도구다.

🧠 Kiota 필요한이유

예를 들어, 어떤 REST API가 있고 그 API의 명세가 OpenAPI 형식으로 되어 있다면, 그걸 기반으로 API 호출 코드를 일일이 짜는 건 귀찮고 실수 발생할 수 있음. Kiota는 그걸 자동화해줌

💡 주요 특징

• ✅ 타입 세이프 타입이 강하게 지정되어 있어서 컴파일 타임에 오류를 잡을 수 있어요.
• 🔄 여러 언어 지원 C#, Java, TypeScript, Go, Python 등 다양한 언어로 클라이언트를 생성할 수 있어요.
• 🔌 OpenAPI 기반 OpenAPI 3.x 명세서만 있으면 바로 사용 가능해요.
• ⚙️ MS Graph와도 호환 Microsoft Graph SDK도 사실 Kiota로 생성된 거예요.
• 🛠️ 사용 예시

kiota generate --language typescript --openapi https://api.example.com/openapi.yaml

이렇게 하면 typescript로 API 호출에 필요한 클라이언트 코드가 전부 생성됨

🎯 용도

• Microsoft Graph API 연동

• 내부 API를 위한 SDK 생성

• OpenAPI 명세서를 기반으로 만든 Teams Toolkit용 API 호출 코드

• 빠르고 안정적인 백엔드-프론트 통신 코드 생성

사용사례 보기