cloud dan hosting

API Adalah: Fungsi, Cara Kerja, Jenis, dan Contoh REST API

API adalah antarmuka yang membuat dua aplikasi bisa saling bertukar data. Kenali cara kerja, endpoint, metode REST API, contoh penggunaan, dan cara mengamankannya.

Ilustrasi API yang menghubungkan dua aplikasi

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.

Analogi sederhana: API seperti pelayan restoran. Anda (aplikasi) memesan lewat pelayan, pelayan meneruskan ke dapur (server), lalu membawa kembali pesanan tanpa Anda perlu masuk ke dapur.

Cara Kerja API

1

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.

2

Server memproses

Server memeriksa izin akses, menjalankan perintah, lalu mengambil atau mengubah data di database.

3

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:

Terminal
curl -H "Authorization: Bearer API_KEY_ANDA" \
     https://api.contoh.com/v1/pelanggan/12
Response JSON
{
  "id": 12,
  "nama": "Budi",
  "paket": "20 Mbps",
  "status": "aktif"
}

Metode Request pada REST API

MetodeFungsiContoh
GETMengambil dataMelihat daftar pelanggan
POSTMenambah data baruMembuat tagihan baru
PUT / PATCHMengubah dataMengganti paket pelanggan
DELETEMenghapus dataMenghapus 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

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.

VPN Website S-Network

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.