Kiota는 관심 있는 OpenAPI 설명 API를 호출하기 위해 API 클라이언트를 생성하기 위한 명령줄 도구입니다. 목표는 호출해야 하는 모든 API에 대해 다른 API SDK에 의존할 필요를 없애는 것입니다. Kiota API 클라이언트는 고품질 API SDK에서 기대하는 모든 기능을 갖춘 강력한 형식의 경험을 제공하지만 모든 HTTP API에 대한 새로운 라이브러리를 배울 필요는 없습니다.
이 라이브러리는 Microsoft.OpenAPI.NET 라이브러리를 기반으로 구축되어 OpenAPI 설명을 사용하는 API에 대한 포괄적인 지원을 보장합니다. 프로젝트의 목표 중 하나는 OpenAPI 및 JSON 스키마 기능에 대해 가능한 최고의 코드 생성기 지원을 제공하는 것입니다. 개념 문서에서는 kiota 작동 방식과 높은 수준의 개념을 설명하고, 이 추가 정보에서는 Kiota를 시작하는 방법을 문서화합니다.
다음 표는 Kiota에서 지원하는 언어에 대한 개요와 다양한 구성 요소 구현의 진행 상황을 제공합니다.
언어 | 세대 | 추상화 | 직렬화 | 입증 | HTTP | 필수 도구 및 종속성 |
---|---|---|---|---|---|---|
CLI | (CSharp 참조) + | (CSharp 참조) | (CSharp 참조) | (CSharp 참조) | 링크 | |
CSharp | ✔ | ✔ | 양식, JSON, 멀티파트, 텍스트 | 익명, API 키, Azure | ✔ | 링크 |
다트 | ▶ | 양식, ▶ JSON, ▶ 멀티파트, 텍스트 | 익명, API 키 | |||
가다 | ✔ | ✔ | 양식, JSON, 멀티파트, 텍스트 | 익명, API 키, Azure | ✔ | 링크 |
자바 | ✔ | ✔ | 양식, JSON, 멀티파트, 텍스트 | 익명, API 키, Azure | ✔ | 링크 |
PHP | ✔ | ✔ | JSON, 양식, 멀티파트, 텍스트 | 익명, ✔️ PHP 리그 | ✔ | 링크 |
파이썬 | ✔ | ✔ | 양식, JSON, 멀티파트, 텍스트 | 익명, Azure | ✔ | 링크 |
루비 | 양식, JSON, 멀티파트, 텍스트 | 익명, OAuth2 | ||||
스위프트 | 양식, JSON, 양식, 텍스트 | 익명, Azure | ||||
타입스크립트/자바스크립트 | 양식, JSON, 멀티파트, 텍스트 | 익명, API 키, Azure, SPFx | 링크 |
범례: ✔ -> 안정적, -> 미리 보기 중, -> 시작되지 않음, ▶ -> 진행 중.
매개변수는 여기에 문서화되어 있습니다.
먼저 필수 구성 요소를 설치했는지 확인하세요. Visual Studio Code를 IDE로 사용하는 경우 launch.json 파일에는 Kiota를 실행하기 위한 구성이 이미 포함되어 있습니다. 기본적으로 이 구성은 SDK를 생성하기 위한 OpenAPI로 PowerShell 리포지토리 아래의 openApiDocs/v1.0/Mail.yml
사용합니다. 기본적으로 이 구성은 이 저장소가 복제된 상위 폴더에 있는 graphdotnetv4|graphjavav4|graphtypescriptv4 폴더에 생성된 파일을 출력합니다.
Visual Studio 디버그 탭에서 API 클라이언트를 생성하려는 언어를 선택하고 F5를 누르면 디버깅 프로세스가 자동으로 빌드, 시작 및 Kiota에 연결됩니다.
Kiota 샘플 저장소에서 Kiota로 생성된 클라이언트 샘플을 찾을 수 있습니다.
여러 API를 호출하는 애플리케이션의 예는 KiotaApp 저장소에서 찾을 수 있습니다.
이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 귀하가 귀하의 기여를 사용할 권리가 있고 실제로 그렇게 할 권리가 있음을 선언하는 기여자 라이센스 계약(CLA)에 동의해야 합니다. 자세한 내용을 보려면 https://cla.opensource.microsoft.com을 방문하세요.
끌어오기 요청을 제출하면 CLA 봇이 자동으로 CLA 제공이 필요한지 여부를 결정하고 PR을 적절하게 장식합니다(예: 상태 확인, 댓글). 봇이 제공하는 지침을 따르기만 하면 됩니다. CLA를 사용하여 모든 저장소에서 이 작업을 한 번만 수행하면 됩니다.
이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택했습니다. 자세한 내용은 행동 강령 FAQ를 참조하거나 추가 질문이나 의견이 있는 경우 [email protected]으로 문의하세요.
이 프로젝트에는 프로젝트, 제품 또는 서비스에 대한 상표나 로고가 포함될 수 있습니다. Microsoft 상표 또는 로고의 승인된 사용에는 Microsoft의 상표 및 브랜드 지침이 적용되며 이를 따라야 합니다. 이 프로젝트의 수정된 버전에 Microsoft 상표 또는 로고를 사용하더라도 혼동을 일으키거나 Microsoft 후원을 암시해서는 안 됩니다. 제3자 상표 또는 로고의 사용에는 해당 제3자의 정책이 적용됩니다.