【Android】KotlinでAPI通信をする方法：Retrofitを使ってGETリクストとPOSTリクエストをマスターする

{ "id": 1, "name": "John Doe", "email": "john@example.com" }

implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.jakewharton.retrofit:retrofit2-kotlinx-serialization-converter:0.8.0'
implementation 'org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.1'

data class User(
    val id: Int,
    val name: String,
    val email: String
)

interface ApiService {
    @GET("users") // GETリクエストで "/users" エンドポイントを呼び出す
    fun getUsers(): Call<List<User>> // サーバーから返されるJSONをList<User(= データクラス)>にマッピング
}

 val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/") // ベースURLを指定
    .addConverterFactory(
        Json {
            ignoreUnknownKeys = true // 未知のキーがあっても無視する設定
        }.asConverterFactory("application/json".toMediaType())
    )
    .build()

// Retrofitを使用してインターフェースを具象化する
val apiService = retrofit.create(ApiService::class.java)

fun fetchUsers() {
    // Retrofitインターフェースからメソッドを呼び出し、APIリクエストを作成
    val call = apiService.getUsers()

    // 非同期でリクエストを実行
    call.enqueue(object : Callback<List<User>> {
        // 通信成功時のコールバック
        override fun onResponse(
            call: Call<List<User>>, // 呼び出し元のCallオブジェクト
            response: Response<List<User>> // サーバーからのレスポンス
        ) {
            if (response.isSuccessful) {
                // HTTPステータスコードが200番台の場合
                val users = response.body() // レスポンスのボディ部分を取得
            } else {
                // レスポンスが失敗した場合の処理（例: 404や500エラー）
            }
        }

        // 通信失敗時のコールバック
        override fun onFailure(call: Call<List<User>>, t: Throwable) {
            // ネットワークエラーやタイムアウト時の処理
        }
    })
}

// 1. データモデルの作成
data class User(
    val id: Int,
    val name: String,
    val email: String
)

// 2. Retrofitインターフェースの作成
interface ApiService {
    @GET("users")
    fun getUsers(): Call<List<User>>
}

// 3. Retrofitインスタンスの作成
val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .build()

// 4. ApiServiceの実装
val apiService = retrofit.create(ApiService::class.java)

// 5. APIリクエストの実行
fun fetchUsers() {
    val call = apiService.getUsers()

    call.enqueue(object : Callback<List<User>> {
        override fun onResponse(
            call: Call<List<User>>,
            response: Response<List<User>> 
        ) {
            if (response.isSuccessful) {
                // 成功時処理
                val users = response.body()
            } else {
                // 失敗時処理
            }
        }

        override fun onFailure(call: Call<List<User>>, t: Throwable) {
            // ネットワークエラーやタイムアウト時の処理
        }
    })
}

// 上記のfetchUsers関数を実行して、ユーザー情報を取得
fun main() {
    fetchUsers()
}

interface ApiService {
    @POST("users")
    fun createUser(@Body newUser: NewUser): Call<CreatedUser>
}

// サーバーに送信する新規ユーザー情報を作成
val newUser = NewUser(name = "John Doe", email = "john.doe@example.com")

// POSTリクエストを実行
val call = apiService.createUser(newUser)
call.enqueue(object : Callback<CreatedUser> {
    override fun onResponse

...続きの処理