Membangun Integrasi API Pertama
Integrasi API pertama sebaiknya kecil, jelas, dan mudah diuji. Materi ini membahas alur data, secrets, retry, idempotency, dan log dasar.
- Memetakan alur data integrasi
- Menjaga secret dan API key
- Menambahkan retry, idempotency, dan log
Sebelum mulai
- Bisa mengirim request API sederhana di Postman.
- Punya contoh dua aplikasi yang ingin dihubungkan.
Konsep utama
01Alur data integrasi
Alur data menjelaskan dari mana data masuk, bagaimana diubah, ke mana dikirim, dan output apa yang disimpan.
Kenapa penting: Integrasi yang jelas lebih mudah dites dan diperbaiki.
Contoh: Lead dari form dibersihkan, divalidasi, lalu dibuat sebagai contact di CRM.
Yang sering keliru: Menghubungkan aplikasi sebelum tahu field mana yang wajib.
02Secrets dan permission
Secrets seperti API key harus disimpan aman dan hanya diberi permission yang dibutuhkan.
Kenapa penting: Kebocoran secret bisa membuka akses ke data atau tindakan penting.
Contoh: Gunakan environment variable atau secret manager, bukan menaruh key di kode publik.
Yang sering keliru: Memakai token admin untuk semua integrasi.
03Retry dan idempotency
Retry mencoba ulang saat request gagal sementara. Idempotency mencegah tindakan yang sama dibuat dua kali.
Kenapa penting: Network bisa gagal, tetapi integrasi tidak boleh membuat order atau invoice ganda.
Contoh: Jika request timeout, workflow mencoba ulang dengan idempotency key yang sama.
Yang sering keliru: Retry tanpa batas sampai data duplikat.
Cara kerjanya
Integrasi API adalah menghubungkan dua atau lebih aplikasi agar data dan proses bisa mengalir otomatis. Pola dasarnya: aplikasi A mengirim request ke API aplikasi B, menerima response, lalu memproses data sesuai kebutuhan.
Setiap API punya cara autentikasi berbeda. API key paling sederhana: cukup tambahkan di header atau query parameter. OAuth lebih kompleks tapi lebih aman untuk akses data user. Bearer token biasanya didapat setelah login. Selalu simpan credential di tempat aman, jangan hardcode di kode.
Error handling penting dalam integrasi. Status code 429 artinya rate limit terlampaui, tunggu sebentar lalu coba lagi dengan exponential backoff. Status 500 artinya server error, coba lagi nanti. Status 400 artinya request salah, cek input. Selalu log error untuk debugging.
Data mapping adalah menghubungkan field dari satu aplikasi ke aplikasi lain. Misal: field 'name' di form → field 'full_name' di CRM. Pastikan format data sesuai (tanggal, angka, string) dan handle kasus kosong atau null.
Contoh nyata
Coba sendiri
- 1
Pilih dua aplikasi yang ingin dihubungkan (misal form dan spreadsheet).
- 2
Dokumentasikan: endpoint, method, auth, request format, response format.
- 3
Buat flow diagram integrasi.
- 4
Test setiap endpoint manual.
- 5
Identifikasi semua kemungkinan error dan tentukan handling-nya.
Prompt yang bisa dipakai
Cek pemahaman
Jawab dengan bahasa sendiri. Kalau masih muter-muter, baca ulang bagian yang paling nyangkut.
- 1
Apa beda API key dan OAuth?
- 2
Kapan harus menggunakan retry dengan backoff?
- 3
Kenapa penting log error dalam integrasi?