KotlinでRetrofitを使ったAPI通信の基本構成をマスターしよう！初心者向けにやさしく解説

1. Retrofitってなに？

1. Retrofitってなに？

Retrofit（レトロフィット）は、KotlinやJavaでAPI通信を簡単にするための人気ライブラリです。普通のネットワーク通信は手順が多くて大変ですが、Retrofitを使うと数行のコードでAPIリクエストができます。

つまり、面倒な作業を代わりにやってくれる「便利屋さん」みたいな存在です。

2. ライブラリって何？どうやって使うの？

2. ライブラリって何？どうやって使うの？

ライブラリとは、よく使う機能がまとめられた「道具箱」のようなものです。Kotlinのプロジェクトで使うには、Gradleというビルドツールに設定を追加します。

たとえば、Retrofitを使うには以下のような記述をbuild.gradle.ktsファイルに追加します。

dependencies {
    implementation("com.squareup.retrofit2:retrofit:2.9.0")
    implementation("com.squareup.retrofit2:converter-gson:2.9.0")
}

3. Retrofitの基本構成を理解しよう

3. Retrofitの基本構成を理解しよう

RetrofitでAPI通信を行うには、以下の3つのステップを踏みます。

• ① APIのルールを定義するインターフェースを作成
• ② 通信の設定をするRetrofitインスタンスを作成
• ③ 実際に通信を行う

それぞれをわかりやすく分解して説明していきます。

4. APIインターフェースを作成する

4. APIインターフェースを作成する

まず、通信のルールを定義するためにインターフェースというものを作成します。ここでは「https://jsonplaceholder.typicode.com/posts/1」というダミーのAPIを使って、記事データを取得してみます。

import retrofit2.Call
import retrofit2.http.GET

interface ApiService {
    @GET("posts/1")
    fun getPost(): Call<Post>
}

5. データクラスを作成しよう

5. データクラスを作成しよう

APIから返ってくるデータを受け取るためには、Kotlinのdata classを使います。JSONという形式で届くデータに合わせて、クラスを用意しておきましょう。

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

6. Retrofitインスタンスを作成する

6. Retrofitインスタンスを作成する

次に、実際に通信するためのRetrofit本体を作ります。ベースとなるURLや、データの形式（Gson）を指定します。

import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory

val retrofit = Retrofit.Builder()
    .baseUrl("https://jsonplaceholder.typicode.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .build()

val service = retrofit.create(ApiService::class.java)

7. 通信を実行して結果を取得する

7. 通信を実行して結果を取得する

最後に、通信を実行してAPIからデータを取得します。ここでは、シンプルに同期的な通信方法（enqueueを使わない）を紹介します。

val response = service.getPost().execute()
if (response.isSuccessful) {
    val post = response.body()
    println("タイトル: ${post?.title}")
    println("内容: ${post?.body}")
} else {
    println("エラーが発生しました。コード: ${response.code()}")
}

8. 実行結果のイメージ

8. 実行結果のイメージ

このコードを実行すると、APIから取得した記事のタイトルと内容が表示されます。

タイトル: sunt aut facere repellat provident occaecati
内容: quia et suscipit...

9. Retrofitを使うメリット

9. Retrofitを使うメリット

Retrofitを使うことで、KotlinでのAPI通信が非常に簡単になります。通信のエラー処理や、データの変換も自動でやってくれるので、初心者にも優しい設計になっています。

特に、インターフェースに注釈（アノテーション）をつけるだけでHTTPの種類（GETやPOSTなど）を指定できる点が便利です。

10. 注意点：ネットワーク通信は時間がかかる

10. 注意点：ネットワーク通信は時間がかかる

ネットワーク通信は、相手のサーバーからの応答を待つ必要があるため、時間がかかる場合があります。そのため、実際のアプリでは通信処理を別スレッドで行うのが基本です（この部分は今後の学習で扱います）。