Ktor API versioning via content type headers examples

api-versioning-content-type-headers.kt

import io.ktor.http.ContentType

// Resource definition
data class MyResource(val name:String)

// Content-type definition
object MyContentTypes {
    object v1 {
        val MyResource = ContentType("application", "vnd.app.myResource-v1+json")
    }
}

// Register a route that only accepts this particular resource
fun Route.myRoute{
  accept(MyContentTypes.v1.MyResource) {
    get("/my-resource") {
      call.respond(MyResource("42"))
    }
  } 
}

// Sample application module - The important bit is registering our custom content-type
fun Application.module(){
  install(ContentNegotiation) {
    register(WebgsContentTypes.v1.SatelliteDefinition, JacksonConverter())
  }
  install(Routing) { myRoute() }
}

// Main
fun main(args: Array<String>) {
    embeddedServer(Netty, 8080, module = Application::module).start(wait = true)
}