Client Plugin

User agent

UserAgent プラグインは、すべてのリクエストに User-Agent ヘッダーを追加します。

依存関係の追加

UserAgent は ktor-client-core アーティファクトのみを必要とし、特定の依存関係は必要ありません。

UserAgent のインストールと設定

UserAgent をインストールするには、クライアント設定ブロック内の install 関数に渡します。次に、agent プロパティを使用して User-Agent の値を指定します。

import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.plugins.*
// ...
val client = HttpClient(CIO) {
    install(UserAgent) {
        agent = "Ktor client"
    }
}

Ktor では、対応する関数を使用して、ブラウザ風または curl 風の User-Agent 値を追加することもできます。

val client = HttpClient(CIO) {
    BrowserUserAgent()
    // ... or
    CurlUserAgent()
}