Prodi Bisnis Digital · FEB UNDIP

Teknologi Web & Mobile

Pertemuan 11: API & Integrasi Sistem

Bagaimana aplikasi, platform, dan mitra bisnis "berbicara" satu sama lain secara otomatis — dan apa yang harus diputuskan seorang manajer produk digital ketika memilih integrasi.

RPS minggu 12 · 2x50 menit

Tujuan Pembelajaran Hari Ini

KONSEP

API

Memahami apa itu API dan mengapa ia jadi tulang punggung bisnis digital

PRAKTIK

Integrasi

Mengenali jenis integrasi, biaya, dan risikonya untuk keputusan produk

Menjelaskan cara kerja API dengan analogi non-teknis (pelayan restoran)
Membedakan REST, autentikasi, dan format data yang lazim dipakai industri
Menghitung biaya dan penghematan dari sebuah keputusan integrasi API
Mengevaluasi kapan integrasi pihak ketiga lebih baik daripada membangun sendiri

Mengapa Ini Penting bagi Manajer Produk Digital?

Hampir tidak ada aplikasi modern yang dibangun 100% sendirian. Setiap kali Anda memesan makanan di GoFood, aplikasi itu memanggil layanan peta, layanan pembayaran, dan sistem resto — semuanya lewat API.

TANPA INTEGRASI

Tim harus membangun peta, pembayaran, SMS sendiri dari nol — mahal & lambat

DENGAN INTEGRASI

Cukup "sambungkan" ke layanan yang sudah ada dan teruji — cepat & hemat

RISIKO BARU

Biaya berlangganan, ketergantungan pada pihak lain, dan celah keamanan

Bagian 1 dari 3

Dasar-Dasar API

Apa itu API, bagaimana ia "berbicara", dan istilah-istilah yang wajib Anda kenali sebelum bicara dengan tim developer.

Apa Itu API?

API (Application Programming Interface, atau "antarmuka pemrograman aplikasi") adalah aturan yang memungkinkan dua aplikasi berbeda saling bertukar data secara otomatis, tanpa manusia mengetik ulang.

Analogi Pelayan Restoran

Anda (aplikasi A) tidak masuk ke dapur untuk memasak sendiri
Pelayan (API) menerima pesanan Anda dalam format tertentu (menu)
Dapur (aplikasi B / server) memproses dan mengirim makanan lewat pelayan yang sama
Anda tidak perlu tahu cara dapur bekerja — cukup tahu cara memesan lewat pelayan

Integrasi Sistem: Menyambung "Pulau-Pulau" Data

Bisnis digital biasanya punya banyak sistem terpisah — e-commerce, gudang, akuntansi, CRM — yang perlu saling bertukar data secara real-time agar bisnis berjalan lancar.

Tanpa integrasi, staf admin harus menyalin data pesanan secara manual ke setiap sistem — lambat dan rawan salah ketik.

Gaya API yang Umum Dipakai Industri

REST

Gaya paling populer — sederhana, pakai format JSON, dipakai hampir semua startup

GRAPHQL

Klien meminta data spesifik saja — efisien untuk aplikasi mobile hemat kuota

SOAP

Lebih kaku & formal — masih dipakai sistem perbankan/pemerintah lama

Untuk keputusan bisnis, Anda tidak perlu memilih gaya API secara teknis — cukup tahu bahwa REST adalah standar de-facto yang paling mudah dicari talent-nya dan paling murah diintegrasikan.

Anatomi Satu "Percakapan" API

Empat metode HTTP yang paling umum, seperti kata kerja dalam kalimat:

Metode	Artinya	Contoh
GET	Ambil data	Lihat detail produk
POST	Kirim data baru	Buat pesanan baru
PUT	Ubah data	Update alamat pengiriman
DELETE	Hapus data	Batalkan pesanan

Format Data: JSON, "Bahasa Bersama" Sistem

JSON (JavaScript Object Notation) adalah format teks ringan untuk bertukar data — hampir semua API modern menggunakannya karena mudah dibaca manusia maupun mesin.

Contoh Respons API Toko Online (disederhanakan)

{
  "nama_produk": "Kemeja Batik",
  "harga": 185000,
  "stok": 42,
  "tersedia": true
}

Bandingkan dengan XML, format lama yang lebih "berat" dan masih dipakai sebagian sistem perbankan/pemerintah — fungsinya sama, hanya lebih verbose (banyak tag pembuka-penutup).

Kode Status: "Bahasa Tubuh" Server

Setiap kali server menjawab, ia menyertakan kode status HTTP tiga digit yang memberi tahu apakah permintaan berhasil, gagal karena kesalahan pengguna, atau gagal karena masalah di server.

Kode	Kategori	Contoh Kasus
200 OK	Berhasil	Data produk berhasil diambil
201 Created	Berhasil dibuat	Pesanan baru berhasil disimpan
400 Bad Request	Kesalahan klien	Format nomor HP salah
401 Unauthorized	Tidak terautentikasi	API key salah/kedaluwarsa
404 Not Found	Tidak ditemukan	Produk sudah dihapus
500 Server Error	Kesalahan server	Sistem mitra sedang down

Bagian 2 dari 3

Integrasi dalam Praktik Bisnis

Keamanan akses, studi kasus payment gateway, dan pola komunikasi webhook vs polling.

Keamanan Akses: API Key & OAuth

API tidak bisa dibuka untuk siapa saja — perlu autentikasi agar hanya aplikasi yang berizin yang bisa mengakses data.

API KEY

Kode rahasia unik per aplikasi — seperti kunci gembok. Sederhana, tapi kalau bocor harus segera diganti (revoke).

OAUTH

Protokol izin bertingkat — misalnya saat login "Masuk dengan Google", Anda mengizinkan akses tanpa membagikan kata sandi Google.

Jangan pernah menaruh API key langsung di kode aplikasi mobile yang bisa dibongkar pengguna — praktik keamanan dasar yang wajib Anda tanyakan ke tim developer.

Bayangkan API key seperti kunci gembok pribadi yang diberikan penyedia layanan ke aplikasi Anda — setiap kali aplikasi Anda memanggil API, ia harus menunjukkan kunci ini agar diizinkan masuk. Kalau kunci ini bocor, misalnya tersimpan di kode aplikasi yang bisa dibongkar orang lain, siapa pun bisa memakainya dan tagihan bisa membengkak atau data bisa dicuri. OAuth sedikit lebih canggih — ini yang Anda alami setiap kali klik tombol "Masuk dengan Google" atau "Masuk dengan Facebook". Anda memberi izin terbatas ke aplikasi tanpa harus membagikan kata sandi asli Anda, dan izin itu bisa dicabut kapan saja lewat pengaturan akun. Sebagai manajer produk, pertanyaan penting yang harus Anda ajukan adalah: "Bagaimana kita menyimpan API key dengan aman?" — ini bukan detail sepele, ini soal reputasi dan kepercayaan pelanggan.

Studi Kasus: Integrasi Payment Gateway

Skenario: sebuah UMKM fesyen online ingin menerima pembayaran QRIS dan kartu kredit lewat penyedia seperti Midtrans/Xendit, alih-alih membangun sistem pembayaran sendiri.

Alur Integrasi Bertahap

1. Daftar & verifikasi — bisnis mendaftar ke penyedia payment gateway, lengkapi dokumen legalitas
2. Dapatkan API key — penyedia memberi kunci akses unik untuk lingkungan uji coba (sandbox) dan produksi
3. Developer integrasikan endpoint — tombol "Bayar Sekarang" memanggil API untuk membuat transaksi
4. Uji di sandbox — simulasi transaksi tanpa uang sungguhan sebelum go-live
5. Go-live & monitoring — transaksi asli berjalan; dashboard memantau sukses/gagal

Coba Sendiri: Bandingkan Biaya Payment Gateway

Ubah nilai transaksi dan jumlah transaksi per bulan, lalu amati bagaimana biaya beberapa penyedia payment gateway berbeda.

Hitung dari Nol: Biaya Kelebihan Kuota API

Sebuah startup logistik berlangganan API pengecekan ongkos kirim dengan kuota 10.000 panggilan/bulan seharga Rp 500.000, dan tarif kelebihan Rp 75/panggilan. Bulan ini terpakai 13.500 panggilan.

Langkah	Perhitungan	Nilai
Kuota termasuk paket	diberikan penyedia	10.000 panggilan
Pemakaian aktual bulan ini	tercatat di dashboard	13.500 panggilan
Kelebihan pemakaian	13.500 − 10.000	3.500 panggilan
Biaya kelebihan	3.500 × Rp 75	Rp 262.500
Biaya langganan dasar	tarif paket bulanan	Rp 500.000
Total tagihan bulan ini	Rp 500.000 + Rp 262.500	Rp 762.500

TOTAL TAGIHAN

Rp 762.500

Coba Sendiri: Hitung Tagihan Kelebihan Kuota API

Ubah kuota paket, pemakaian aktual, dan tarif kelebihan, lalu amati bagaimana total tagihan bulanan berubah.

Webhook vs Polling: Dua Cara "Dapat Kabar"

POLLING

Aplikasi Anda bertanya berulang-ulang ke server, "sudah selesai belum?" — seperti menelepon kurir tiap 5 menit. Boros, tapi sederhana.

WEBHOOK

Server mengabari Anda otomatis begitu ada kejadian — seperti kurir mengirim notifikasi WhatsApp saat paket tiba. Efisien, real-time.

Contoh nyata: setelah pembeli bayar via Midtrans, webhook otomatis memberi tahu sistem toko bahwa pembayaran sukses — status pesanan berubah tanpa staf mengecek manual.

Bagian 3 dari 3

Memilih & Mengelola Integrasi

Dokumentasi API, trade-off "beli vs bangun sendiri", dan menghitung dampak bisnis dari otomasi.

Dokumentasi API: "Buku Manual" yang Menentukan Kecepatan

Sebelum developer bisa mengintegrasikan API pihak ketiga, mereka butuh dokumentasi — semacam buku petunjuk yang menjelaskan endpoint, parameter, dan contoh respons.

Contoh Alat Dokumentasi Populer

Swagger / OpenAPI — standar industri, developer bisa "coba langsung" API dari halaman dokumentasi
Postman Collection — kumpulan contoh permintaan siap pakai untuk uji coba cepat
SDK (Software Development Kit) — paket kode siap pakai dari penyedia API agar integrasi lebih cepat

Dokumentasi yang buruk = waktu integrasi molor, biaya membengkak. Ini kriteria bisnis, bukan cuma teknis, saat memilih vendor API.

Bayangkan Anda membeli perabot IKEA — kalau buku manualnya jelas dengan gambar langkah demi langkah, perakitan cepat selesai. Kalau manualnya berantakan, Anda bisa buang waktu berjam-jam bahkan salah pasang. Dokumentasi API bekerja persis seperti itu untuk developer. Swagger atau OpenAPI adalah standar yang memungkinkan developer bahkan "mencoba" memanggil API langsung dari halaman dokumentasi sebelum menulis kode sungguhan. SDK adalah paket kode siap pakai yang disediakan vendor API, misalnya SDK dari Midtrans untuk bahasa pemrograman tertentu, sehingga developer tidak perlu menulis semuanya dari nol. Sebagai manajer produk, ketika membandingkan dua vendor API dengan harga mirip, kualitas dokumentasi bisa jadi faktor penentu — vendor dengan dokumentasi buruk akan membuat proyek Anda molor dan biaya developer membengkak.

Trade-off: Pakai API Pihak Ketiga vs Bangun Sendiri

Kriteria	API Pihak Ketiga	Bangun Sendiri
Kecepatan ke pasar	Cepat (hitungan hari-minggu)	Lambat (bulan-tahun)
Biaya awal	Rendah	Tinggi (tim developer khusus)
Kontrol & kustomisasi	Terbatas sesuai fitur vendor	Penuh, sesuai kebutuhan unik
Ketergantungan	Bergantung pada uptime vendor	Tanggung jawab penuh internal

Aturan praktis: pakai API pihak ketiga untuk fungsi bukan-inti-bisnis (peta, pembayaran, SMS). Bangun sendiri untuk fungsi yang jadi keunggulan kompetitif Anda.

Hitung dari Nol: Penghematan dari Otomasi API

Toko online memasukkan pesanan secara manual ke sistem gudang. Admin bergaji Rp 4.325.000/bulan untuk 173 jam kerja, dan tiap pesanan butuh 3 menit input manual. Volume: 2.000 pesanan/bulan.

Langkah	Perhitungan	Nilai
Rate upah per jam	Rp 4.325.000 ÷ 173 jam	Rp 25.000/jam
Waktu input manual per pesanan	3 menit = 3÷60 jam	0,05 jam
Biaya manual per pesanan	0,05 jam × Rp 25.000	Rp 1.250
Total biaya manual/bulan	2.000 × Rp 1.250	Rp 2.500.000
Biaya setelah integrasi API	otomatis, waktu staf ≈ 0	~Rp 0
Penghematan per bulan	Rp 2.500.000 − ~Rp 0	~Rp 2.500.000

PENGHEMATAN/BULAN

~Rp 2,5 juta

Sekarang kita hitung dampak nyata dari integrasi API terhadap biaya operasional, langkah demi langkah. Admin digaji Rp 4.325.000 untuk 173 jam kerja sebulan, jadi rate per jamnya Rp 25.000 — angka ini pas karena 4.325.000 dibagi 173 hasilnya bulat. Tiap pesanan butuh 3 menit input manual, atau setara 0,05 jam, sehingga biaya tenaga kerja per pesanan adalah 0,05 dikali Rp 25.000 sama dengan Rp 1.250. Dengan 2.000 pesanan sebulan, total biaya manual mencapai Rp 2,5 juta. Setelah integrasi API terpasang — misalnya pesanan dari Shopee otomatis masuk ke sistem gudang tanpa input manual — biaya tenaga kerja untuk tugas ini mendekati nol, sehingga penghematannya sekitar Rp 2,5 juta per bulan. Inilah jenis angka yang perlu Anda siapkan kalau ingin meyakinkan manajemen untuk berinvestasi pada integrasi API.

Rangkuman & Persiapan Pertemuan Berikutnya

Cheat Sheet Hari Ini

API = jembatan komunikasi otomatis antar sistem (analogi pelayan restoran)
REST + JSON = standar paling umum; kode status memberi tahu hasil permintaan
API key/OAuth menjaga keamanan akses; webhook lebih efisien dari polling
Pilih API pihak ketiga untuk fungsi bukan-inti; hitung biaya vs penghematan

MINGGU DEPAN

Keamanan

Pertemuan 12: Keamanan Web & Mobile

Bawa laptop — kita akan bahas ancaman umum (phishing, data breach) dan praktik keamanan dasar untuk produk digital.

Mari kita rangkum perjalanan dua jam kita hari ini. Anda sudah belajar bahwa API adalah jembatan komunikasi otomatis antar sistem, dengan REST dan JSON sebagai standar paling umum dipakai industri saat ini. Anda juga sudah paham pentingnya keamanan lewat API key dan OAuth, perbedaan webhook dan polling, serta yang paling penting — cara menghitung dampak finansial dari sebuah keputusan integrasi, baik dari sisi biaya kelebihan kuota maupun penghematan operasional. Minggu depan di pertemuan 12, kita lanjut ke topik yang berkaitan erat: keamanan web dan mobile. Setelah tahu bagaimana sistem saling terhubung lewat API, langkah wajib berikutnya adalah memahami bagaimana menjaga koneksi itu tetap aman dari ancaman seperti kebocoran data atau serangan siber, jadi pastikan Anda sudah menguasai istilah-istilah hari ini sebagai bekal.