Apa Itu API? Pengertian, Cara Kerja, Jenis API, dan Contoh Implementasinya
Apa Itu API? Pengertian, Cara Kerja, Jenis API, dan Contoh Implementasinya
Di era digital saat ini, hampir semua aplikasi saling terhubung melalui API. Ketika Anda login menggunakan akun Google, melakukan pembayaran melalui Midtrans, mengirim pesan menggunakan WhatsApp, atau melihat prakiraan cuaca pada sebuah aplikasi, kemungkinan besar semua proses tersebut melibatkan API.
Bagi developer, API merupakan salah satu komponen paling penting dalam pengembangan aplikasi modern. API memungkinkan dua sistem yang berbeda saling bertukar data tanpa harus mengetahui bagaimana sistem tersebut dibangun secara internal.
Pada artikel ini Anda akan mempelajari pengertian API, cara kerjanya, jenis-jenis API, metode HTTP yang digunakan, format data JSON, hingga contoh implementasi API dalam dunia nyata.
Apa Itu API?
API (Application Programming Interface) adalah sekumpulan aturan, protokol, dan mekanisme yang memungkinkan dua aplikasi atau lebih saling berkomunikasi dan bertukar data secara otomatis.
API bertindak sebagai perantara antara aplikasi client dan server. Client mengirimkan permintaan (request), kemudian server memproses permintaan tersebut dan mengembalikan hasilnya dalam bentuk response.
Client
│
HTTP Request
│
▼
API Server
│
Business Logic
│
Database
│
HTTP Response
▼
Client
Mengapa API Dibutuhkan?
Tanpa API, setiap aplikasi harus mengakses database aplikasi lain secara langsung. Pendekatan tersebut tidak aman dan sulit dikelola.
Dengan API, pengembang hanya memberikan akses terhadap data yang memang diperbolehkan sehingga keamanan aplikasi menjadi lebih terjaga.
Beberapa manfaat API antara lain:- Integrasi antar aplikasi menjadi lebih mudah.
- Keamanan data lebih terkontrol.
- Pengembangan aplikasi menjadi lebih cepat.
- Mengurangi duplikasi data.
- Mempermudah otomatisasi proses bisnis.
Bagaimana Cara Kerja API?
Misalkan aplikasi mobile ingin mengambil daftar produk dari server.
Mobile App
↓
GET /api/products
↓
API Server
↓
PHP / Laravel
↓
MySQL
↓
JSON Response
↓
Mobile App
Server akan menerima request, menjalankan logika aplikasi, mengambil data dari database, kemudian mengirimkan hasilnya dalam format JSON.
HTTP Method pada API
| Method | Fungsi |
|---|---|
| GET | Mengambil data. |
| POST | Menambah data baru. |
| PUT | Mengubah seluruh data. |
| PATCH | Mengubah sebagian data. |
| DELETE | Menghapus data. |
Contoh Endpoint API
GET
/api/books
Mengambil seluruh data buku.
GET
/api/books/10
Mengambil data buku dengan ID 10.
POST
/api/books
Menambahkan buku baru.
DELETE
/api/books/10
Menghapus buku dengan ID 10.
Request API
Contoh request menggunakan format JSON.
POST /api/books
{
"title":"Belajar PHP",
"author":"Ibnu Khalim",
"year":2026
}
Response API
{
"status":"success",
"message":"Data berhasil disimpan",
"data":{
"id":15,
"title":"Belajar PHP"
}
}
Apa Itu JSON?
JSON (JavaScript Object Notation) merupakan format pertukaran data yang ringan dan mudah dibaca baik oleh manusia maupun mesin.
Sebagian besar REST API modern menggunakan JSON sebagai format utama dalam proses request maupun response.
Status Code HTTP
| Status | Arti |
|---|---|
| 200 | OK |
| 201 | Created |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |
REST API
REST (Representational State Transfer) merupakan arsitektur API yang paling banyak digunakan saat ini. REST memanfaatkan protokol HTTP dan setiap resource diakses melalui URL tertentu.
Contoh:
GET /api/users
POST /api/users
PUT /api/users/5
DELETE /api/users/5
Contoh API dalam Kehidupan Sehari-hari
- Login menggunakan Google.
- Pembayaran Midtrans.
- WhatsApp Business API.
- Google Maps API.
- OpenWeather API.
- API Raja Ongkir.
- API YouTube.
- API GitHub.
Keamanan API
API sebaiknya tidak dapat diakses secara bebas. Oleh karena itu biasanya digunakan mekanisme autentikasi seperti:
- API Key
- Bearer Token
- JWT (JSON Web Token)
- OAuth 2.0
Kesimpulan
API merupakan jembatan komunikasi antar aplikasi. Dengan API, berbagai sistem dapat saling bertukar data secara aman dan efisien tanpa harus mengakses database secara langsung. Memahami konsep API menjadi bekal penting bagi developer modern karena hampir seluruh aplikasi berbasis web maupun mobile saat ini memanfaatkan API sebagai media komunikasi utama.