API (Application Programming Interface) adalah perantara, atau lebih tepatnya sebuah “kontrak”, yang memungkinkan dua aplikasi saling “berbicara” dan bertukar data. Kamu meminta sesuatu lewat sebuah alamat khusus bernama endpoint, lalu API mengembalikan data yang kamu minta, biasanya dalam format JSON. Setiap kali aplikasi cuaca di HP-mu menampilkan suhu terbaru, atau kamu login ke sebuah website pakai akun Google, di balik layar ada API yang bekerja mengantarkan data antar-aplikasi.

Buat pemula, kata “API” sering terdengar menakutkan dan penuh istilah teknis. Padahal konsepnya sangat sederhana kalau dijelaskan dengan analogi yang tepat. Di panduan ini kamu akan paham betul apa itu API, bagaimana cara kerjanya langkah demi langkah, istilah-istilah pentingnya, apa itu REST API, contoh nyata di aplikasi sehari-hari, sampai cara memanggil API sendiri dengan JavaScript. Tidak perlu jadi ahli backend dulu, cukup pahami idenya.

Apa Itu API?

API adalah singkatan dari Application Programming Interface. Secara harfiah artinya “antarmuka pemrograman aplikasi”, sebuah pintu resmi yang disediakan satu aplikasi agar aplikasi lain bisa memakainya. Alih-alih membiarkan aplikasi lain mengacak-acak isi dapurnya, sebuah aplikasi menyediakan API sebagai jalur yang rapi dan terkontrol untuk meminta data atau menjalankan aksi.

Analogi paling mudah adalah pelayan restoran. Bayangkan kamu datang ke restoran. Kamu (pelanggan) tidak boleh langsung masuk ke dapur dan memasak sendiri. Sebagai gantinya, kamu memesan lewat menu, memberi tahu pelayan, lalu pelayan itu meneruskan pesananmu ke dapur. Setelah makanan siap, pelayan yang sama mengantarnya ke mejamu.

Dalam analogi ini:

Kamu (pelanggan) = aplikasi yang meminta data (client).
Menu = daftar hal yang bisa kamu minta (endpoint).
Pelayan = API, perantara yang mengantar permintaan dan membawa balik hasilnya.
Dapur = server tempat data diproses.

Kamu tidak perlu tahu bagaimana cara dapur memasak; kamu cukup tahu cara memesan lewat menu. Itulah inti API: ia menyembunyikan kerumitan di balik antarmuka yang sederhana.

Perlu dicatat, istilah “API” sebenarnya luas, tidak semua API berhubungan dengan web. Sistem operasi punya API, library kode punya API, bahkan tombol di aplikasi desktop memanggil API di baliknya. Tapi di dunia web development, saat orang bilang “API”, yang paling sering dimaksud adalah web API: layanan yang diakses lewat internet menggunakan protokol HTTP. Panduan ini fokus ke web API karena itulah yang paling relevan saat kamu belajar membangun website.

Cara Kerja API

Inti cara kerja web API adalah siklus request → response: aplikasi mengirim permintaan (request), API meneruskannya ke server, server memproses, lalu mengirim balik jawaban (response). Mari kita bedah langkah demi langkah.

Client mengirim request. Aplikasi (misalnya browser atau aplikasi HP) mengirim permintaan ke sebuah alamat API. Permintaan ini menyebut apa yang diinginkan lewat endpoint dan jenis aksinya lewat HTTP method. Contoh: GET /api/produk berarti “ambilkan daftar produk”.
API meneruskan ke server. API menerima permintaan, memeriksanya (misalnya cek apakah kamu punya izin), lalu meminta data yang dibutuhkan ke server atau database.
Server memproses. Server menjalankan logika yang diperlukan, mencari data di database, menghitung sesuatu, atau menyimpan data baru.
API mengirim response. Server mengembalikan hasil ke API, dan API mengirimnya balik ke client. Response berisi status code (kode yang menandakan berhasil atau gagal) dan data, hampir selalu dalam format JSON.

Diagram di bawah ini menggambarkan seluruh siklusnya: permintaan bergerak ke kanan, lalu data mengalir kembali ke client.

Request →GET /api/produk

Clientbrowser / aplikasiAPIperantara / pelayanServerdatabase / logika

← Response200 OK · { "produk": [ ... ] }

ClientAPIServer

API = pelayan restoran: kamu (client) pesan lewat menu (endpoint), dapur (server) masak, pelayan antar hasilnya.

Beberapa istilah kunci di siklus ini yang wajib kamu kenal:

HTTP method menentukan jenis aksi. Yang paling umum: GET (mengambil data), POST (mengirim/membuat data baru), PUT (memperbarui data), dan DELETE (menghapus data).
Status code adalah angka tiga digit di response yang memberi tahu hasilnya. 200 berarti sukses, 404 berarti “tidak ditemukan”, dan 500 berarti server bermasalah. Kamu akan sering ketemu ketiganya.
Response body adalah data sesungguhnya yang dikembalikan. Untuk web API modern, format ini hampir selalu JSON, teks terstruktur yang mudah dibaca manusia maupun program.

Jadi kalau disederhanakan: kamu bilang “mau apa” (method) “dari mana” (endpoint), server menjawab “berhasil atau tidak” (status code) sambil menyerahkan “ini datanya” (JSON).

Istilah Penting dalam API

Sebelum lanjut, mari rangkum istilah-istilah yang akan terus kamu temui saat berurusan dengan API. Menghafal ini akan membuat dokumentasi API mana pun terasa jauh lebih ramah.

Endpoint, alamat (URL) spesifik tempat kamu meminta sesuatu. Contoh: https://api.toko.com/produk atau /users/1. Anggap endpoint sebagai satu “menu” yang bisa dipesan.
Request, permintaan yang dikirim client ke API. Berisi method, endpoint, header, dan kadang payload.
Response, jawaban yang dikembalikan API. Berisi status code dan data (biasanya JSON).
Method, jenis aksi: GET, POST, PUT, DELETE. Menentukan apa yang mau kamu lakukan pada data.
Header, informasi tambahan yang menyertai request atau response, misalnya Content-Type: application/json atau token autentikasi.
Status code, angka hasil: 200 (OK), 201 (berhasil dibuat), 404 (tidak ditemukan), 401 (belum login), 500 (error server).
Payload / body, data yang dikirim bersama request (misalnya data form saat POST) atau data yang dikembalikan di response.

Apa Itu REST API?

REST API adalah gaya (atau “arsitektur”) paling umum dalam membangun web API saat ini. REST kependekan dari Representational State Transfer. Kamu tidak perlu menghafal kepanjangannya, yang penting dipahami adalah cara berpikirnya: semua hal di sistem dianggap sebagai resource (sumber daya), dan kamu berinteraksi dengannya lewat kombinasi endpoint + HTTP method.

Misalnya, sebuah aplikasi punya resource bernama users. Dengan REST, pola interaksinya konsisten dan mudah ditebak:

GET /users, ambil daftar semua user.
GET /users/1, ambil satu user dengan id 1.
POST /users, buat user baru.
PUT /users/1, perbarui data user id 1.
DELETE /users/1, hapus user id 1.

Perhatikan betapa rapinya: satu endpoint dasar (/users) dipakai untuk banyak aksi berbeda, dan yang membedakan aksinya cukup method dan id-nya. Konsistensi inilah alasan REST begitu populer, sekali kamu paham polanya, kamu bisa menebak cara memakai API baru bahkan tanpa membaca dokumentasinya secara detail.

Selain REST, ada gaya lain seperti GraphQL dan gRPC, tapi untuk pemula, REST adalah yang paling penting dan paling banyak kamu temui di dunia nyata.

Contoh Nyata API di Kehidupan Sehari-hari

API bukan konsep abstrak, kamu memakainya puluhan kali setiap hari tanpa sadar. Berikut beberapa contoh nyata yang membuat konsepnya jadi konkret:

Aplikasi cuaca, aplikasi cuaca di HP tidak menyimpan data cuaca sendiri. Ia memanggil API layanan cuaca (misalnya BMKG atau OpenWeather) untuk mengambil suhu dan prakiraan terbaru.
Peta / Google Maps, banyak aplikasi (ojek online, aplikasi kuliner, situs properti) menampilkan peta dengan memanggil Google Maps API, bukan membuat peta sendiri dari nol.
Payment gateway, saat kamu membayar di toko online, website itu memanggil API payment gateway (seperti Midtrans atau Xendit) untuk memproses transaksi dengan aman tanpa menyentuh data kartumu langsung.
“Sign in with Google”, tombol login pakai akun Google bekerja lewat API autentikasi Google. Website meminta izin ke Google, Google memverifikasi identitasmu, lalu mengembalikan konfirmasi.
Data produk e-commerce, aplikasi mobile sebuah toko online mengambil daftar produk, harga, dan stok dari API backend toko tersebut. Website dan aplikasi HP-nya memakai API yang sama.

Benang merahnya: kapan pun sebuah aplikasi butuh data atau layanan dari aplikasi lain, API-lah jembatannya.

Contoh Memanggil API dengan Fetch (JavaScript)

Cara paling umum memanggil API di browser adalah dengan fungsi bawaan JavaScript bernama fetch. Berikut contoh sederhana mengambil data dari sebuah API dan mengubahnya menjadi objek JavaScript:

// 1. Panggil endpoint API dengan fetch (default method-nya GET)
fetch('https://jsonplaceholder.typicode.com/users/1')
  // 2. Ubah response mentah menjadi JSON (menghasilkan Promise)
  .then(res => res.json())
  // 3. Setelah JSON siap, gunakan datanya
  .then(data => {
    console.log(data.name)   // nama user
    console.log(data.email)  // email user
  })
  // 4. Tangani kalau ada error (misalnya koneksi putus)
  .catch(error => console.error('Gagal mengambil data:', error))

Alurnya persis siklus request-response yang tadi kita bahas: fetch mengirim request ke endpoint, API mengembalikan response, lalu res.json() mengubah body-nya menjadi objek yang bisa kamu pakai. Perhatikan .then() yang berantai, ini karena fetch bersifat asynchronous (butuh waktu menunggu jawaban dari server). Kamu bisa langsung mencoba dan berlatih memanggil API dengan fetch di Hyper Sheets, lengkap dengan latihan interaktif di browser tanpa perlu setup apa pun. Kalau kamu masih baru dengan JavaScript sendiri, sebaiknya pahami dulu apa itu JavaScript sebagai fondasinya.

Public API Gratis untuk Latihan

Kabar baiknya, kamu tidak perlu membangun backend sendiri untuk mulai berlatih memanggil API. Ada banyak public API gratis yang sengaja disediakan untuk belajar. Dua yang paling populer:

JSONPlaceholder, API palsu berisi data contoh (users, posts, comments) yang sempurna untuk latihan fetch pertamamu. Endpoint seperti https://jsonplaceholder.typicode.com/posts langsung mengembalikan JSON.
PokeAPI, API berisi data lengkap semua Pokémon. Menyenangkan untuk latihan karena datanya kaya dan mudah diverifikasi.

Kesalahan Umum dan Miskonsepsi tentang API

Beberapa salah paham sering menghambat pemula. Meluruskannya sejak awal akan menghematmu banyak kebingungan.

API bukan database. Ini miskonsepsi paling umum. Database adalah tempat data disimpan; API adalah pintu untuk meminta data. API bisa mengambil data dari database, tapi keduanya bukan hal yang sama. Kamu tidak pernah “mengakses database langsung” lewat API publik, kamu meminta ke API, dan API-lah yang berurusan dengan database.

API bukan server (tapi dilayani oleh server). Server adalah komputer/program yang berjalan; API adalah antarmuka yang server itu sediakan. Satu server bisa menyediakan banyak API.

Tidak semua API bebas diakses, sebagian butuh API key. Banyak API mengharuskan kamu menyertakan sebuah API key (semacam kata sandi unik) di setiap request untuk mengidentifikasi dan membatasi siapa yang boleh memakainya. Ini normal, terutama untuk API berbayar atau yang punya batas pemakaian.

Cek Pemahaman

Aplikasi cuaca di HP menampilkan suhu terbaru yang datanya berasal dari server BMKG. Apa peran API di sini?

FAQ Seputar API

API adalah apa dengan bahasa sederhana?

API adalah perantara yang memungkinkan dua aplikasi bertukar data. Ibarat pelayan restoran: kamu memesan lewat menu, pelayan meneruskan ke dapur, lalu mengantar makananmu. Aplikasimu meminta sesuatu lewat API, API mengurus permintaan itu ke server, lalu membawa balik hasilnya, biasanya berupa data JSON.

Apa itu API dalam pemrograman web?

Dalam pemrograman web, API (web API) adalah layanan yang bisa diakses lewat internet menggunakan protokol HTTP. Aplikasi mengirim request ke sebuah endpoint (alamat), dan API mengembalikan response berisi status code dan data. Ini cara frontend (tampilan) dan backend (server) saling berkomunikasi, juga cara aplikasi berbeda saling terhubung.

Apa itu REST API?

REST API adalah gaya paling umum dalam membangun web API. Ia memperlakukan segala sesuatu sebagai resource dan berinteraksi dengannya lewat kombinasi endpoint dan HTTP method. Contohnya GET /users/1 untuk mengambil user, POST /users untuk membuat user baru. Kelebihannya adalah polanya konsisten dan mudah ditebak.

Apa itu endpoint?

Endpoint adalah alamat (URL) spesifik tempat kamu meminta sesuatu ke API. Misalnya https://api.toko.com/produk adalah endpoint untuk mengambil data produk. Satu API biasanya punya banyak endpoint, masing-masing untuk kebutuhan berbeda, anggap saja seperti daftar menu yang bisa kamu pesan.

Apa itu API key?

API key adalah semacam kata sandi unik yang kamu sertakan di setiap request untuk mengidentifikasi siapa yang memakai API. Fungsinya untuk mengontrol akses, membatasi pemakaian, dan (untuk API berbayar) menghitung tagihan. Ingat: API key yang bersifat rahasia tidak boleh ditaruh di kode frontend publik karena bisa dicuri.

Contoh API apa saja yang sering dipakai?

Contoh API yang sering dipakai antara lain API cuaca (BMKG, OpenWeather), Google Maps API untuk peta, payment gateway seperti Midtrans dan Xendit untuk pembayaran, API autentikasi Google untuk “Sign in with Google”, dan API e-commerce untuk data produk. Untuk latihan, public API gratis seperti JSONPlaceholder dan PokeAPI sangat direkomendasikan.

Langkah Selanjutnya

Sekarang kamu sudah paham fondasi API: apa itu, cara kerjanya lewat siklus request-response, istilah pentingnya, apa itu REST, dan cara memanggilnya dengan fetch. Langkah paling efektif berikutnya adalah praktik langsung. Ambil sebuah public API gratis, panggil dengan fetch, lalu tampilkan datanya di halaman.

Kalau kamu benar-benar baru di web development dan belum pernah membuat halaman sendiri, mulai dari membuat website pertama untuk membangun fondasinya, lalu kuatkan pemahaman apa itu JavaScript sebelum menyelam lebih dalam ke pemanggilan API. Menguasai API adalah salah satu keterampilan yang membedakan seseorang yang bisa membuat halaman statis dengan seseorang yang bisa membangun aplikasi web sungguhan yang terhubung dengan data nyata.