Что нужно сделать, чтобы описать GET-запрос?

REST-интерфейс, URL, HTTP-метод GET.

interface ApiService {
    @GET("/api/v1/items") // Описание GET-запроса с указанием пути
    suspend fun getItems(): List<Item> // Функция для выполнения запроса, возвращающая список Item
}

Использую библиотеку Retrofit2 для создания клиента и выполнения запросов.

val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/") // Базовый URL API
    .addConverterFactory(GsonConverterFactory.create()) // Конвертер для парсинга JSON
    .build()

val apiService = retrofit.create(ApiService::class.java) // Создание экземпляра сервиса

// Выполнение запроса в корутине или другом потоке
try {
    val items = apiService.getItems()
    // Обработка полученных данных
} catch (e: Exception) {
    // Обработка ошибки
}

В зависимости от задачи могут потребоваться параметры запроса (Query Parameters) или заголовки (Headers).

interface ApiService {
    @GET("/api/v1/items")
    suspend fun getItems(
        @Query("category") category: String? = null, // Параметр запроса "category"
        @Header("Authorization") authHeader: String // Заголовок "Authorization"
    ): List<Item>
}