API & Webhook buat Non-Developer
Lesson 1 dari 3 · Menengah · 35 sampai 45 menit

API dan webhook untuk non-developer

API dan webhook membuat aplikasi bisa saling berkomunikasi. Materi ini menjelaskan request, response, JSON, auth, event, dan risiko integrasi dengan bahasa non-developer.

Setelah selesai, kamu bisaLesson 1 dari 3
  • Membedakan API dan webhook
  • Mengenali request, response, dan JSON
  • Memahami auth dan rate limit dasar

Sebelum mulai

  • Paham trigger dan action pada automation.
  • Tidak perlu pengalaman backend, tetapi siapkan rasa penasaran untuk membaca contoh JSON.
Target belajar: Setelah selesai, kamu bisa membaca alur API sederhana dan membedakan kapan memakai request API atau webhook.

Konsep utama

01API sebagai penghubung aplikasi

API adalah aturan yang dipakai satu aplikasi untuk meminta data atau menjalankan tindakan di aplikasi lain.

Kenapa penting: Hampir semua integrasi modern bergantung pada API, dari CRM sampai payment gateway.

Contoh: Form website mengirim nama dan email ke CRM lewat API, lalu CRM mengembalikan status berhasil.

Yang sering keliru: Mengira semua API bebas dipakai tanpa key, permission, dan format data.

02Request, response, dan JSON

Request adalah data yang dikirim ke API. Response adalah jawaban yang diterima. JSON sering dipakai sebagai format data di antara keduanya.

Kenapa penting: Memahami tiga hal ini membantu kamu membaca docs dan mencari penyebab integrasi gagal.

Contoh: Request berisi email pelanggan; response mengembalikan customer_id dan status created.

Yang sering keliru: Tidak membaca pesan error di response.

03Webhook sebagai notifikasi event

Webhook mengirim pesan otomatis ketika suatu event terjadi, tanpa perlu aplikasi lain bertanya terus-menerus.

Kenapa penting: Webhook cocok untuk proses real-time seperti pembayaran berhasil, form terkirim, atau ticket baru.

Contoh: Saat pembayaran berhasil, payment gateway mengirim webhook ke sistem order.

Yang sering keliru: Tidak memverifikasi signature webhook sehingga rawan request palsu.

Cara kerjanya

API adalah cara aplikasi berbicara dengan aplikasi lain. Kita mengirim request ke endpoint, lalu menerima response. Webhook adalah cara aplikasi mengirim notifikasi otomatis saat sesuatu terjadi. Untuk automation AI, API dan webhook adalah fondasi penting.

API key adalah kunci akses. Jangan pernah menaruh API key di publik, screenshot, repository terbuka, atau prompt sembarangan. Rate limit adalah batas pemakaian. Cost control penting karena AI API bisa mahal jika automation berjalan tanpa limit.

Peserta non-developer tidak perlu langsung coding kompleks. Cukup paham konsep: input, endpoint, method, headers, body JSON, response, error, dan retry. Tools no-code biasanya menyembunyikan detail teknis, tapi pemahaman dasar tetap membuat debugging lebih mudah.

Contoh nyata

Saat form Tally dikirim, webhook mengirim data ke Make/n8n. Automation lalu memanggil API AI untuk membuat summary lead, kemudian menyimpan hasil ke Airtable.

Coba sendiri

  1. 1

    Lihat contoh JSON sederhana.

  2. 2

    Identifikasi field nama, email, kebutuhan.

  3. 3

    Buat prompt yang memakai data JSON sebagai input.

Prompt yang bisa dipakai

Jelaskan payload JSON berikut dengan bahasa pemula. JSON: [tempel JSON]. Buat juga contoh cara data ini dipakai dalam automation AI.

Cek pemahaman

Jawab dengan bahasa sendiri. Kalau masih muter-muter, baca ulang bagian yang paling nyangkut.

  1. 1

    Apa beda API dan webhook?

  2. 2

    Apa itu API key?

  3. 3

    Kenapa rate limit penting?

Tugas

Buat diagram alur data dari form -> webhook -> AI -> database -> notifikasi.

Lanjut ke materi berikutnya

Setelah konsep API dan webhook jelas, lanjut ke Postman untuk mengetes request secara langsung.
RAGEmbeddingVector DatabaseAI Agent
Lanjut: Testing API dengan Postman