Konsep REST API dan Format JSON

14 Okt 2026kribbiadminMobile Programming

Tujuan Pembelajaran

Menjelaskan konsep REST API dan HTTP.
Memahami metode GET, POST, PUT, DELETE.
Menjelaskan struktur data JSON.
Membaca dan memetakan JSON ke objek Dart.

Uraian Materi

Aplikasi mobile jarang bekerja sendiri; sebagian besar mengambil dan mengirim data ke server. REST API adalah standar antarmuka yang memungkinkan aplikasi berkomunikasi dengan server melalui protokol HTTP. REST menggunakan URL sebagai sumber daya dan metode HTTP sebagai aksi.

Metode HTTP

Empat metode utama: GET untuk mengambil data, POST untuk menambah data, PUT untuk memperbarui data, dan DELETE untuk menghapus data. Kombinasi metode dan endpoin membentuk permintaan yang jelas terhadap layanan.

Format JSON

JSON (JavaScript Object Notation) adalah format pertukaran data berbasis teks yang mudah dibaca manusia dan mesin. Contoh struktur JSON:

{
  "nama": "Rudi",
  "npm": "20223001",
  "aktif": true,
  "nilai": [78, 85, 90]
}

Di dalam JSON dikenal objek (kurung kurawal), array (kurung siku), string, angka, boolean, dan null.

Memetakan JSON ke Dart

Data JSON diubah menjadi objek Dart agar mudah dipakai aplikasi. Teknik: definisikan class, tulis fromJson untuk mengisi objek dari map, dan toJson untuk kebalikannya.

class Mahasiswa {
  final String nama;
  final int npm;
  Mahasiswa({required this.nama, required this.npm});

  factory Mahasiswa.fromJson(Map json) {
    return Mahasiswa(nama: json['nama'], npm: json['npm']);
  }
}

Perencanaan Konsumsi API

Modul ini menutup dasar – peserta siap menulis model untuk endpoint yang akan dikonsumsi pada pertemuan berikutnya dengan paket http.

Konsep Endpoint dan Sumber Daya

Endpoint adalah alamat URL spesifik yang mewakili sumber daya, misal /produk untuk koleksi produk dan /produk/5 untuk satu produk dengan id 5. Perancangan endpoint yang jelas memudahkan pengembang membaca dan memakai API tanpa dokumentasi berlebih.

Status Kode sebagai Bahasa Respon

Jenis respon dikenali dari kode status HTTP: 2xx menandakan keberhasilan, 4xx kesalahan dari sisi klien (misal 404 tidak ditemukan), dan 5xx kesalahan server. Membaca status kode sebelum mem-parsing isi respon mencegah banyak error tak terduga.

Struktur Data yang Stabil

Desain JSON yang konsisten – nama field yang sama pada seluruh respon dan tata letak yang bisa diprediksi – memudahkan pemetaan ke model Dart. Peserta belajar menyesuaikan model dengan struktur field agar dariJson akurat sebelum data dipakai.

Menyiapkan Lingkungan Uji API

Untuk berlatih tanpa server sendiri, tersedia API publik dummy seperti jsonplaceholder dengan data contoh. Peserta mengamati format respon melalui alat bantu, kemudian berlatih memetakannya ke model. Keterampilan ini menjadi dasar materi konsumsi API berikutnya.

Aktivitas Pembelajaran

Menjelaskan konsep REST dan metode HTTP.
Mengamati contoh permintaan dan respon API.
Menulis class Dart dengan dariJson.
Melatih parsing JSON melalui contoh data.

Tugas dan Latihan

Buat class Produk dengan dariJson dari data JSON yang diberikan.
Daftarkan 4 endpoint beserta metode HTTP dan fungsinya.
Simulasikan parsing array JSON menjadi List.

Evaluasi

Evaluasi dilakukan melalui pengamatan hasil praktikum, kuis singkat di akhir pertemuan, dan pemantauan proyek. Peserta yang belum mencapai indikator tertentu diberikan remedial melalui bimbingan ulang dan latihan tambahan pada pertemuan berikutnya.

Panduan umum praktik, catatan belajar, dan refleksi tersedia di Panduan Belajar Kribbi Study.