Ktor Client — Cliente HTTP para Kotlin

O que é Ktor Client?

Ktor Client é um cliente HTTP assíncrono para a linguagem de programação Kotlin, desenvolvido pela empresa JetBrains. Ele faz parte do framework Ktor, que é projetado para criar aplicações servidoras e clientes. Ktor Client permite enviar requisições HTTP (GET, POST, PUT, DELETE e outras) e processar respostas, suportando trabalho com diversos motores (OkHttp, Apache, CIO, Android, etc.).

Para que serve o Ktor Client?

Ktor Client é usado para interagir com REST APIs, baixar dados da internet, enviar formulários, trabalhar com WebSocket, bem como para integração com serviços em nuvem. Ele é totalmente escrito em Kotlin, o que garante segurança de tipos e código conciso. Graças ao suporte a coroutines e Flow, Ktor Client é ideal para aplicações assíncronas e reativas.

Como instalar o Ktor Client?

Para usar Ktor Client em um projeto Kotlin, adicione as dependências no arquivo build.gradle.kts:

dependencies {    implementation("io.ktor:ktor-client-core:2.3.12")    implementation("io.ktor:ktor-client-cio:2.3.12") // motor CIO    implementation("io.ktor:ktor-client-content-negotiation:2.3.12") // para JSON    implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.12") // serialização}

Se você usa Maven, adicione as dependências correspondentes no pom.xml.

Principais funcionalidades

• Múltiplos motores: OkHttp, Apache, CIO, Android, iOS (Darwin), JavaScript.
• Assincronicidade: Suporte total a coroutines Kotlin (funções suspend).
• Plugins: Content Negotiation (JSON/XML), Logging, Auth (Basic, Bearer, OAuth), Cookies, WebSocket.
• Segurança de tipos: Serialização e desserialização via kotlinx.serialization.
• Transmissão por streaming: Trabalho com arquivos grandes via streaming.

Exemplo de código em Kotlin

import io.ktor.client.*import io.ktor.client.engine.cio.*import io.ktor.client.request.*import io.ktor.client.statement.*import io.ktor.http.*import kotlinx.serialization.Serializableimport io.ktor.client.plugins.contentnegotiation.*import io.ktor.serialization.kotlinx.json.*

@Serializabledata class Post(val userId: Int, val id: Int, val title: String, val body: String)

suspend fun fetchPost(): Post {    val client = HttpClient(CIO) {        install(ContentNegotiation) {            json()        }    }    val response: HttpResponse = client.get("https://jsonplaceholder.typicode.com/posts/1")    val post: Post = response.body()    client.close()    return post}

fun main() = runBlocking {    val post = fetchPost()    println("Title: ${post.title}")}

Quando usar Ktor Client?

Ktor Client é recomendado para uso em projetos Kotlin (JVM, Android, Native, JS) onde é necessário um cliente HTTP leve, assíncrono e moderno. Ele é especialmente útil em microsserviços, aplicações Android, projetos multiplataforma (KMP) e ao trabalhar com Kotlin Coroutines. Se você precisa de integração total com o ecossistema Kotlin e JetBrains, Ktor Client é a melhor escolha.