microsoft/kiota
Kiota
Kiota is a multi-language SDK generator and REST API client orchestrator that transforms OpenAPI descriptions into strongly typed client libraries. It provides a framework for managing API specifications and generating typed interfaces to eliminate manual boilerplate development.
The project utilizes a template-driven source emission system to map API specifications to native language types. It ensures consistency across environments using lock-file version syncing and organizes API endpoints into a nested object structure based on the hierarchical mapping of URI paths.
The toolset includes utilities for searching, downloading, and visualizing API descriptions, as well as mechanisms for automated client generation within continuous integration pipelines. It supports a pluggable request-response pipeline for custom middleware, API data serialization, and the management of authentication tokens and private registry access.
Features
- REST API Client Generators - Transforms OpenAPI descriptions into strongly typed client libraries to eliminate manual boilerplate.
- Multi-Language Client Generation - Provides a system for generating complete, type-safe SDKs across multiple programming languages from a single API specification.
- Schema-to-Native Type Mappings - Converts OpenAPI data types into native language primitives to ensure compile-time safety for payloads.
- Code Generators - Automatically transforms API specification files into executable source code for type-safe clients.
- Client Specification Synchronization - Keeps local client libraries in sync with remote API specifications using lock files and automated workflows.
- OpenAPI Client SDK Generators - Generates strongly typed HTTP client SDKs and type definitions directly from OpenAPI specifications.
- Version Locking - Uses lock files to record specific API description versions and ensure reproducible client generation across environments.
- REST API Integrations - Connects applications to RESTful services using generated code that ensures type safety and consistent serialization.
- SDK Generation Automation - Automatically produces and updates language-specific SDKs whenever the underlying API definition changes.
- Source Code Templates - Uses a template-driven system to emit language-specific client libraries by mapping specification entities to code templates.
- Version Syncing - Ensures generated clients remain consistent across environments by tracking API description versions via lock files.
- Data Serialization - Provides capabilities to convert raw server responses into native objects and transform local data for API consumption.
- API Client Generators - Integrates with CI pipelines to automatically update and generate client libraries when API specifications change.
- Path Tree Visualizations - Includes utilities for visualizing the hierarchical path tree of API descriptions.
- Middleware-Based Request Pipelines - Implements a pluggable chain of handlers to intercept and process network requests and responses.
- API Authentication Management - Manages credentials and authorization tokens based on the security schemes defined within the API specifications.
- Custom Middleware Implementations - Provides a pluggable mechanism to insert custom logic into the request-response pipeline for logging and telemetry.
- Hierarchical Object Mapping - Organizes API endpoints into a nested object structure that reflects the logical hierarchy of URI paths.
- HTTP Middleware Pipelines - Enables adding custom logic for logging, telemetry, and header manipulation via a client-side HTTP middleware pipeline.
