KotlinのAPI通信をコルーチンで実装する基本テクニックを解説！初心者でもできる非同期通信

先生と生徒の会話形式で理解しよう

生徒

「KotlinでインターネットにアクセスするAPI通信って、どうやって書くんですか？よく“コルーチン”って言葉も出てきて難しそうで…」

先生

「たしかに最初は難しく感じるかもしれないけど、Kotlinのコルーチンを使えば、スムーズで効率のよいAPI通信が書けるようになるんだよ。」

生徒

「コルーチンって何ですか？普通の関数と何が違うんでしょう？」

先生

「簡単に言うと、“待っている間に他の作業もできる関数”のことなんだ。じゃあ一緒に基本から学んでいこう！」

1. API通信と非同期処理の関係

API通信とは、アプリやシステムが外部のサービス（たとえば天気予報やニュース）にアクセスして、情報をもらう仕組みのことです。ですが、通信は時間がかかるため、その間に画面が止まってしまうと使いにくいアプリになってしまいます。

そのため「非同期処理（ひどうきしょり）」を使って、通信している間も他の操作を続けられるようにします。これを簡単に実現できるのがKotlinのコルーチンです。

2. コルーチンとは？初心者向けにやさしく解説

コルーチンは「軽くて柔軟な並行処理の仕組み」です。たとえば、友達からの返事を待つ間に、他の友達にLINEを送ったり、YouTubeを見たりできるようなイメージです。

通常の関数は処理が終わるまで次に進めませんが、コルーチンを使えば「一時停止」と「再開」ができるため、待ち時間を有効活用できます。

3. API通信を実装する準備をしよう

今回は、API通信のために人気のあるHTTPクライアントライブラリOkHttpを使って、コルーチンと組み合わせてみましょう。

まずはGradleのbuild.gradle.ktsに以下を追加してください：


dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
    implementation("com.squareup.okhttp3:okhttp:4.12.0")
}

4. コルーチンを使った基本のAPI通信コード

それでは、KotlinでコルーチンとOkHttpを使ったシンプルなAPI通信の基本コードを見てみましょう。


import kotlinx.coroutines.*
import okhttp3.OkHttpClient
import okhttp3.Request

fun main() = runBlocking {
    launch {
        val response = fetchApiData("https://example.com/api/data")
        println("APIの結果: $response")
    }
}

suspend fun fetchApiData(url: String): String {
    val client = OkHttpClient()
    val request = Request.Builder().url(url).build()
    return client.newCall(request).execute().use { response ->
        response.body?.string() ?: "エラー: レスポンスが空です"
    }
}

runBlockingはコルーチンを始めるためのスタート地点です。そしてlaunchで非同期処理を開始しています。suspendというキーワードは「この関数はコルーチンの中で使うよ」という目印です。

5. 実行結果のイメージ

上記のコードを実行すると、以下のようにAPIから取得した文字列が表示されます（URLはダミーです）。


APIの結果: {"message":"こんにちは","status":"ok"}

6. なぜsuspendが必要なのか？

suspend関数は、コルーチンの中でだけ呼び出せる特別な関数です。これは「ちょっと待ってから戻ってくるかもしれない関数」と考えてください。

通信は時間がかかるので、処理が終わるまで待つ必要がありますが、suspendを使えばその間に他の作業もこなせるので、アプリが止まらずスムーズに動きます。

7. エラーが出たときの対処法

API通信は、インターネットの状況やURLのミスで失敗することもあります。そういったときは、例外処理を使ってエラーをキャッチするのが大事です。

次のようにtry-catchを使うと安全です：


suspend fun fetchApiData(url: String): String {
    return try {
        val client = OkHttpClient()
        val request = Request.Builder().url(url).build()
        client.newCall(request).execute().use { response ->
            response.body?.string() ?: "レスポンスが空です"
        }
    } catch (e: Exception) {
        "通信エラー: ${e.message}"
    }
}