ktor-openapi-tools - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #llm #golang #machine-learning #nodejs #kubernetes #awesome-list #pytorch #ios #mcp #open-source

ktor-openapi-tools

(★ 285)

A collection of libraries to simplify API documentation and exploration for Ktor applications. Generates OpenAPI specifications and provides Swagger UI and ReDoc.

File Explorer

Download Latest Version (.zip)

- - checks.yml
  - publish.yml
  - publish_docs.yml
- detekt.yml
- - authentication.md
  - basics.md
  - complete-configuration.md
  - customized-schema-generator.md
  - external-openapi-spec.md
  - file-upload.md
  - index.md
  - kotlinx-serialization.md
  - multiple-specs.md
  - openapi-examples.md
  - petstore.md
  - request-response.md
  - schemas.md
  - webhooks.md
- - getting_started.md
  - index.md
  - plugin_configuration.md
  - providing_openapi_specification.md
  - troubleshooting_and_faq.md
- - getting_started.md
  - index.md
- - getting_started.md
  - index.md
- changelog.md
- index.md
- build.gradle.kts
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
- build.gradle.kts
- build.gradle.kts
- build.gradle.kts
.editorconfig
.gitignore
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
LICENSE
mkdocs.yml
README.md
requirements.txt
settings.gradle.kts

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Ktor OpenAPI Tools

[![Version](https://img.shields.io/maven-central/v/io.github.smiley4/ktor-openapi?style=flat&color=blue&logo=apachemaven)](https://search.maven.org/search?q=g:io.github.smiley4%20a:ktor-openapi)
[![Checks Passing](https://img.shields.io/github/actions/workflow/status/SMILEY4/ktor-openapi-tools/checks.yml?style=flat&logo=github)](https://github.com/SMILEY4/ktor-openapi-tools/actions/workflows/checks.yml)
[![License](https://img.shields.io/github/license/SMILEY4/ktor-openapi-tools?style=flat&color=teal)](https://github.com/SMILEY4/ktor-openapi-tools/blob/develop/LICENSE)

A collection of libraries to simplify API documentation and exploration for [Ktor](https://ktor.io/) applications. Designed to be non-invasive, they integrate seamlessly with applications without requiring immediate change to existing code while being highly customizable to fit every use case.

**Documentation** can be found [here](https://smiley4.github.io/ktor-openapi-tools/latest/) and in the [wiki](https://github.com/SMILEY4/ktor-openapi-tools/wiki) for older versions.

## OpenAPI

Ktor plugin to automatically generate [OpenAPI](https://www.openapis.org/) specifications from routes. Additional information can be gradually added to existing routes without requiring major changes to existing code.

- Extends existing Ktor DSL
- No immediate change to code required
- Support for [Type-safe routing](https://ktor.io/docs/server-resources.html) / Resources plugin
- Document webhooks and (limited) options for server-sent events
- Covers (almost) complete [OpenAPI 3.1.0 Specification](https://swagger.io/specification/)
- Automatically generates json schemas from kotlin types
  - Out-of-the-box support for type parameters, inheritance, collections, etc
  - Usable with reflection or [kotlinx.serialization](https://github.com/Kotlin/kotlinx.serialization)
  - Supports [Jackson](https://github.com/FasterXML/jackson), [Swagger](https://github.com/swagger-api/swagger-core), [Javax](https://mvnrepository.com/artifact/javax.validation/validation-api)
    and [Jakarta](https://github.com/jakartaee/validation/tree/main) annotations
  - Highly configurable and customizable

```kotlin
// Install and configure the OpenAPI plugin.
install(OpenApi)

routing {
    
    route("api.json") {
        // Create a route to expose the OpenAPI specification file at `/api.json`.
        openApi()
    }
    
    get("example", {
        // Add (optional) information to the route, e.g. a description and responses and response bodies.
        description = "An example route"
        response {
            HttpStatusCode.OK to {
                description = "A success response"
                body<String>()
            }
        }
    }) {
        // Handle requests as usual.
        call.respondText("Hello World!")
    }
}
```

## Swagger UI

Library for Ktor applications to serve [Swagger UI](https://swagger.io/tools/swagger-ui/) - visualize and interact with generated OpenAPI specifications.

- Explore and interact with OpenAPI specifications generated by [`ktor-openapi`](../openapi/index.md) or external specifications
- Serve bundled Swagger UI
- Expose multiple "instances" of Swagger UI (e.g. for different OpenAPI specifications)
- All Swagger UI configuration options available

```kotlin
routing {
    
    route("swagger") {
        // Expose Swagger UI using OpenAPI specification at `/api.json`.
        // Path can be relative pointing to specification provided by this application or absolute pointing to an external resource.
        swaggerUI("/api.json") {
            // Add configuration for this Swagger UI "instance" here.
        }
    }
    
}
```

## ReDoc

Library for Ktor applications to serve [ReDoc](https://github.com/Redocly/redoc) - visualize and interact with generated OpenAPI specifications.

- Explore and interact with OpenAPI specifications generated by [`ktor-openapi`](../openapi/index.md) or external specifications
- Serve bundled ReDoc page
- Expose multiple "instances" of ReDoc (e.g. for different OpenAPI specifications)
- All ReDoc configuration options available

```kotlin
routing {
    
    route("redoc") {
        // Expose ReDoc showing OpenAPI specification at `/api.json`.
        // Path can be relative pointing to specification provided by this application or absolute pointing to an external resource.
      redoc("/api.json") {
            // Add configuration for this ReDoc "instance" here.
        }
    }
    
}
```