Pernahkah kamu bertanya-tanya, bagaimana aplikasi belanja online bisa menampilkan status pengiriman dari ekspedisi? Atau bagaimana sebuah website bisa menyediakan tombol "Masuk dengan Google"? Satu dari sekian banyak jawabannya mengarah pada satu teknologi, yaitu API.

Istilah ini sangat sering muncul di dunia IT. Sayangnya, banyak pemula yang masih bingung membedakan API dengan aplikasi biasa. Tenang saja, karena di artikel ini kita akan membahasnya dengan bahasa yang santai. Simak baik-baik artikel ini ya!

Apa itu API?

API (Application Programming Interface) adalah seperangkat aturan yang memungkinkan satu aplikasi berkomunikasi dan bertukar data dengan aplikasi lain tanpa perlu mengetahui cara kerja di dalamnya. API menentukan permintaan apa yang boleh diajukan, format data yang digunakan, dan jawaban apa yang akan diterima.

Sesuai dengan namanya, API adalah interface atau antarmuka. Bedanya, antarmuka ini bukan untuk manusia, melainkan untuk program.

Seperti Pelayan di Restoran

Biar tidak terasa membosankan, mari kita pakai analogi restoran.

Bayangkan kamu duduk di sebuah restoran. Kamu tidak masuk ke dapur untuk mengambil makanan sendiri. Kamu cukup melihat menu, lalu menyampaikan pesanan kepada pelayan. Pelayan membawa pesananmu ke dapur, lalu kembali dengan makanan yang sudah matang.

Dalam dunia IT, perannya kurang lebih seperti ini:

• Pelanggan adalah aplikasi client, misalnya aplikasi di ponselmu.
• Menu adalah dokumentasi API, yang berisi daftar permintaan yang boleh diajukan.
• Pelayan adalah API itu sendiri.
• Dapur adalah server dan database.
• Makanan adalah data yang dikembalikan.

Kamu tidak perlu tahu bagaimana dapur memasaknya. Kamu hanya perlu tahu cara memesan dengan benar. Inilah alasan API sangat penting, karena sistem yang kompleks bisa dipakai tanpa harus dibuka isinya.

Cara Kerja API

Secara garis besar, cara kerja API melalui empat tahap berikut:

1. Request: client mengirim permintaan ke alamat tertentu yang disebut endpoint.
2. Proses: API meneruskan permintaan ke server, lalu server memprosesnya.
3. Response: server mengirim hasilnya kembali melalui API.
4. Tampil: client menampilkan data tersebut kepada pengguna.

Sebagai contoh, berikut gambaran sederhana request untuk mengambil data produk:

GET https://api.contohtoko.id/produk/101

Dan inilah response dalam format JSON yang mungkin diterima:

{

  "id": 101,

  "nama": "Keyboard Mekanik",

  "harga": 450000,

  "stok": 12

}

JSON (JavaScript Object Notation) adalah format data teks yang ringan dan mudah dibaca, sehingga menjadi format paling populer untuk API modern.

Mengenal HTTP Method dan Status Code

Dalam REST API, ada beberapa HTTP method yang perlu kamu kenali:

• GET: mengambil data.
• POST: menambahkan data baru.
• PUT/PATCH: memperbarui data.
• DELETE: menghapus data.

Setiap response juga membawa status code sebagai penanda hasil:

• 200 OK: permintaan berhasil.
• 404 Not Found: data atau alamat tidak ditemukan.
• 500 Internal Server Error: terjadi kesalahan di sisi server.

Fungsi API

Lantas, apa saja manfaat API bagi pengembang maupun pebisnis?

1. Integrasi sistem: menghubungkan aplikasi yang berbeda, seperti payment gateway dengan toko online.
2. Efisiensi pengembangan: developer tidak perlu membuat fitur dari nol, misalnya peta atau prakiraan cuaca.
3. Keamanan terkontrol: akses ke data bisa dibatasi dan diatur melalui otorisasi.
4. Skalabilitas: aplikasi bisa dikembangkan per bagian tanpa merombak seluruh sistem.

Jenis-Jenis API

Ada dua cara umum untuk mengelompokkan API.

Berdasarkan Hak Akses

• Public/Open API: terbuka untuk umum, biasanya cukup dengan mendaftar.
• Partner API: hanya untuk mitra bisnis tertentu.
• Private/Internal API: dipakai internal perusahaan saja.
• Composite API: menggabungkan beberapa API dalam satu request.

Berdasarkan Arsitektur

• REST: paling populer, memakai HTTP dan umumnya berformat JSON.
• SOAP: berbasis XML dengan aturan yang ketat, sering dipakai di sistem perbankan dan korporasi lama.
• GraphQL: client bisa meminta data persis sesuai kebutuhan, tidak lebih dan tidak kurang.

Contoh Penggunaan API dalam Kehidupan Sehari-Hari

• Login dengan akun Google atau Facebook pada berbagai website.
• Peta di aplikasi transportasi online yang memakai layanan peta pihak ketiga.
• Pembayaran di toko online lewat payment gateway.
• Prakiraan cuaca di aplikasi ponsel yang mengambil data dari penyedia data cuaca.
• Cek ongkos kirim langsung dari data ekspedisi.

Keamanan API yang Wajib Diperhatikan

Perlu diketahui juga bahwa API yang tidak diamankan bisa menjadi celah serangan. Beberapa praktik dasarnya:

• Gunakan HTTPS agar data terenkripsi saat dikirim.
• API key sebagai identitas pemanggil. Jangan pernah menaruhnya di kode yang bisa dilihat publik.
• OAuth 2.0 untuk otorisasi yang lebih aman, seperti pada fitur "Masuk dengan Google".
• Rate limiting untuk membatasi jumlah request dan mencegah penyalahgunaan.
• Validasi input agar data berbahaya tidak lolos ke server.