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

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}"
    }
}

8. KotlinのコルーチンとAPI通信の相性の良さ

Kotlinのコルーチンは、API通信ととても相性が良いです。なぜなら、シンプルなコードで、複雑な非同期処理が書けるからです。

これまでのようにCallbackなどを使って複雑なコードを書く必要がなくなり、読みやすくて保守もしやすいプログラムになります。

また、Androidアプリなどでもこの手法は非常に一般的で、多くのエンジニアが使っています。

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

9. Kotlinの非同期通信をマスターしよう

KotlinのAPI通信にコルーチンを使うことで、ネットワークと連携する処理を安全かつ効率的に実装することができます。

このテクニックを覚えておけば、天気予報を取得したり、ログイン認証をしたり、外部のデータベースとやりとりしたりと、さまざまな場面で役立ちます。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。