Jetpack Compose Academy · Pelajaran

Mendefinisikan Interface API Retrofit

Deklarasikan endpoint dengan anotasi.

Pelajaran 1 dari 413 langkah

Mendefinisikan Interface API Retrofit adalah pelajaran Jetpack Compose Academy gratis di CoddyKit. Ini adalah pelajaran 1 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Jetpack Compose Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Jetpack Compose Academy mencakup 4 pelajaran total.

Fungsi Retrofit

Retrofit mengubah interface Kotlin biasa menjadi klien HTTP yang berfungsi. Anda cukup mendeskripsikan API, lalu Retrofit menulis kode jaringan untuk Anda.

Dimulai dari Interface

Anda mendeklarasikan setiap titik akhir sebagai fungsi di dalam interface Kotlin. Retrofit membaca anotasinya dan membuat implementasi nyata saat runtime.

interface UserApi {
    // endpoint functions go here
}

Menandai Permintaan GET

Anotasi @GET memberi tahu Retrofit bahwa fungsi ini mengambil data. Anda meneruskan jalur yang berada setelah URL dasar. 🌐

@GET("users")
fun getUsers(): Call<List<User>>

POST, PUT, dan DELETE Juga

Selain GET, Retrofit menyediakan @POST, @PUT, dan @DELETE sehingga satu interface dapat membaca dan menulis data di server Anda.

@POST("users")
fun createUser(@Body user: User): Call<User>

Parameter Jalur

Gunakan @Path untuk menyisipkan nilai ke dalam URL. Retrofit mengganti penanda bernama di dalam kurung kurawal dengan argumen yang Anda teruskan.

@GET("users/{id}")
fun getUser(@Path("id") id: Int): Call<User>

Parameter Kueri

Tambahkan @Query untuk nilai setelah tanda tanya, seperti istilah pencarian atau nomor halaman. Retrofit menambahkannya ke URL untuk Anda.

@GET("search")
fun search(@Query("q") term: String): Call<Result>

Jenis Nilai Kembalian

Jenis nilai kembalian fungsi memberi tahu Retrofit bentuk data yang diharapkan. data class di sini dipetakan langsung ke respons JSON.

@GET("users/{id}")
fun getUser(@Path("id") id: Int): Call<User>

Menetapkan URL Dasar

Anda membuat satu objek Retrofit dengan URL dasar. Setiap jalur titik akhir yang Anda deklarasikan akan otomatis digabungkan dengannya.

val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .build()

Membuat Implementasi

Panggil create dengan class interface Anda, lalu Retrofit mengembalikan objek yang siap digunakan. Anda tidak perlu menulis kode permintaan sendiri.

val api = retrofit.create(UserApi::class.java)

Menambahkan Pabrik Konverter

converter factory mengajarkan Retrofit cara mengubah JSON menjadi data class Anda. Anda menambahkannya sekali saat membuat objek.

.addConverterFactory(MoshiConverterFactory.create())

Jangan Lupa Izinnya

Untuk mengakses jaringan, deklarasikan izin INTERNET di manifes Anda. Tanpanya, setiap permintaan gagal bahkan sebelum dimulai.

<uses-permission android:name="android.permission.INTERNET" />

Pemeriksaan Singkat

Anotasi mana yang menyisipkan nilai langsung ke jalur URL?

Jawab di pelajaran interaktif

Ringkasan: Interface API Anda

Anda mendeskripsikan titik akhir sebagai fungsi interface beranotasi, menetapkan URL dasar, menambahkan konverter, dan membiarkan Retrofit membuat klien. Selanjutnya, Anda akan mengurai JSON yang dikembalikannya.

Gratis untuk memulai

Belajar Kotlin dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus: 30
Pelajaran: 120

Mulai belajar gratis Lihat kursus lengkapnya

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mendefinisikan Interface API Retrofit” gratis?

Ya — teks lengkap “Mendefinisikan Interface API Retrofit” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Jetpack Compose Academy, upgrade ke CoddyKit PRO. Kursus Jetpack Compose Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Mendefinisikan Interface API Retrofit”?

Deklarasikan endpoint dengan anotasi. Kamu berlatih Jetpack Compose Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Jetpack Compose Academy?

Tidak diperlukan pengalaman sebelumnya. Jetpack Compose Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 1 dari 4.

Berapa lama pelajaran “Mendefinisikan Interface API Retrofit” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Jetpack Compose Academy ini?

Ya. Setiap pelajaran Jetpack Compose Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Jetpack Compose Academy