API adalah singkatan dari Application Programming Interface, yaitu "jembatan" yang memungkinkan dua aplikasi saling bertukar data dan perintah dengan aturan yang sudah disepakati. Saat aplikasi ojek online menampilkan peta, toko online mengecek ongkos kirim, atau sistem billing mengirim tagihan lewat WhatsApp, semuanya berjalan lewat API.
Artikel ini membahas cara kerja API, istilah endpoint, request, dan response, jenis-jenis API seperti REST API, contoh penggunaan API di kehidupan sehari-hari termasuk WhatsApp API, serta cara mengamankannya.
Cara Kerja API
Client mengirim request
Aplikasi mengirim permintaan ke alamat tertentu yang disebut endpoint, misalnya https://api.contoh.com/v1/pelanggan, lengkap dengan metode, header, dan API key.
Server memproses
Server memeriksa izin akses, menjalankan perintah, lalu mengambil atau mengubah data di database.
Server mengirim response
Hasilnya dikirim kembali, biasanya dalam format JSON, bersama kode status HTTP seperti 200 (berhasil), 401 (tidak diizinkan), atau 404 (tidak ditemukan).
Contoh request dan response REST API:
curl -H "Authorization: Bearer API_KEY_ANDA" \
https://api.contoh.com/v1/pelanggan/12
{
"id": 12,
"nama": "Budi",
"paket": "20 Mbps",
"status": "aktif"
}
Metode Request pada REST API
| Metode | Fungsi | Contoh |
|---|---|---|
GET | Mengambil data | Melihat daftar pelanggan |
POST | Menambah data baru | Membuat tagihan baru |
PUT / PATCH | Mengubah data | Mengganti paket pelanggan |
DELETE | Menghapus data | Menghapus voucher |
Jenis-Jenis API
Berdasarkan akses
- Open/public API: bisa dipakai developer umum, biasanya dengan API key.
- Partner API: hanya untuk mitra yang sudah bekerja sama.
- Private API: dipakai internal antar sistem di satu perusahaan.
Berdasarkan arsitektur
- REST API: paling populer, memakai HTTP dan JSON.
- GraphQL: client menentukan sendiri data yang diminta.
- SOAP: berbasis XML, masih dipakai sistem lama dan perbankan.
- Webhook: server yang mengirim data ke aplikasi Anda saat ada kejadian.
Contoh Penggunaan API
- Pembayaran: payment gateway dan QRIS mengirim status pembayaran ke toko online.
- Ongkos kirim: toko online mengambil tarif dari API ekspedisi.
- Login dengan Google: website memakai API Google untuk verifikasi akun.
- WhatsApp API: aplikasi mengirim notifikasi, OTP, dan tagihan otomatis lewat WhatsApp gateway.
- Router MikroTik: RouterOS menyediakan API dan REST API sehingga aplikasi billing bisa membuat user atau mengubah limit secara otomatis.
Cara Mengamankan API
- Selalu pakai HTTPS dengan sertifikat SSL.
- Simpan API key dan token di server, jangan di kode frontend atau repository publik.
- Batasi jumlah request (rate limit) untuk mencegah penyalahgunaan.
- Validasi semua input dan beri hak akses secukupnya untuk setiap key.
- Untuk API internal, batasi akses berdasarkan IP atau lewat VPN.
Panduan Terkait
- SaaS adalah: contoh dan beda IaaS, PaaS, dan SaaS
- WhatsApp gateway adalah: fungsi dan cara kerjanya
- Database adalah: fungsi, jenis, dan contohnya
- HTTP adalah: cara kerja, metode, dan kode status
- Web server adalah: fungsi, cara kerja, dan contoh software
- Localhost adalah: arti 127.0.0.1 dan cara mengaksesnya
Pertanyaan Seputar API
API adalah apa?
API adalah antarmuka yang memungkinkan dua aplikasi saling bertukar data dan perintah dengan aturan yang sudah ditentukan, tanpa perlu mengetahui cara kerja internal aplikasi lainnya.
API adalah singkatan dari apa?
API adalah singkatan dari Application Programming Interface.
Apa itu REST API?
REST API adalah jenis API yang memakai protokol HTTP dengan metode GET, POST, PUT, dan DELETE, dan biasanya mengirim data dalam format JSON.
Apa itu endpoint API?
Endpoint adalah alamat URL tertentu pada API yang menerima request untuk satu jenis data atau fungsi, misalnya /v1/pelanggan.
Apa itu WhatsApp API?
WhatsApp API adalah cara bagi aplikasi untuk mengirim dan menerima pesan WhatsApp secara otomatis, misalnya untuk notifikasi, OTP, atau pengingat tagihan.
Apa itu API key?
API key adalah kode rahasia yang dipakai aplikasi untuk membuktikan bahwa ia berhak memakai sebuah API. API key harus disimpan dengan aman dan tidak dibagikan.
Online-kan API lokal dengan domain dan HTTPS
Publikasikan web dan API yang berjalan di server lokal lewat domain dengan SSL gratis, tanpa IP public dan tanpa membuka port di router. Mulai Rp10.000 per bulan.