# API Adalah: Pengertian, Cara Kerja, Jenis, dan Contoh

> API adalah kontrak yang membuat dua aplikasi bisa bertukar data. Pahami pengertian, cara kerja, jenis REST hingga GraphQL, contoh, dan keamanannya.

**URL:** https://www.ciptadusa.com/blog/api-adalah  
**Type:** blog  
**Author:** PT Cipta Dua Saudara  
**Category:** Teknologi  
**Published:** 2026-10-28  
**Cover:** https://www.ciptadusa.com/media/uploads/blog/2026-10/1793158640696-api-adalah-20261028.webp  

## Article

API adalah singkatan dari Application Programming Interface, yaitu kontrak yang memungkinkan satu software mengakses data atau menjalankan fungsi milik software lain. AWS mendefinisikannya sebagai mekanisme yang memungkinkan dua komponen perangkat lunak saling berkomunikasi menggunakan serangkaian definisi dan protokol ([sumber](https://aws.amazon.com/id/what-is/api/)). IBM menambahkan bahwa API hanya membuka data dan fungsi yang diperlukan untuk satu interaksi tertentu, sementara detail internal sistem tetap tersembunyi ([sumber](https://www.ibm.com/think/topics/api)).

Kalau Anda mencari "API adalah dalam IT", istilah yang dimaksud adalah API di dunia software ini, bukan api sebagai reaksi kimia atau API sebagai standar oli mesin. Artikel ini membahas pengertian API, cara kerjanya, jenis-jenisnya, contoh di bisnis, perbedaannya dengan webhook dan middleware, keamanan API, serta hal yang perlu disiapkan sebelum membangun atau mengintegrasikan API.

## Pengertian API

Menurut AWS, kata "aplikasi" dalam API merujuk pada perangkat lunak dengan fungsi tertentu, sedangkan kata "antarmuka" dapat diartikan sebagai kontrak layanan antara dua aplikasi. Kontrak ini menjelaskan cara keduanya berkomunikasi lewat permintaan (request) dan respons (response), dan dokumentasi API berisi cara developer menyusun keduanya ([sumber](https://aws.amazon.com/id/what-is/api/)).

Analogi sederhananya (penyederhanaan CDS): API mirip menu dan pelayan di restoran. Pelanggan tidak perlu masuk ke dapur. Ia cukup memesan sesuai menu, lalu pelayan membawa pesanan ke dapur dan kembali membawa makanan. Menu adalah kontraknya, dapur adalah sistem internal yang tidak perlu terlihat oleh pelanggan.

Contoh dari AWS: sistem perangkat lunak BMKG menyimpan data cuaca harian, lalu aplikasi cuaca di ponsel mengambil data itu melalui API dan menampilkannya ke pengguna ([sumber](https://aws.amazon.com/id/what-is/api/)).

### Kepanjangan dan Arti API dalam IT

| Istilah | Arti |
| --- | --- |
| Application | Perangkat lunak yang punya fungsi tertentu, misalnya aplikasi toko online, sistem gudang, atau layanan pembayaran |
| Programming | Komunikasi dilakukan oleh program (kode), bukan oleh manusia yang mengklik tombol |
| Interface | Titik temu berupa aturan: data apa yang boleh diminta, formatnya seperti apa, dan respons apa yang dikembalikan |

IBM mencatat ada banyak kelas API: API hardware dan firmware, API sistem operasi, API library dan framework, API database, serta web API. Dalam percakapan sehari-hari, kata API kerap dipakai sebagai sinonim web API, yaitu API yang menerima request lewat jaringan, umumnya memakai HTTP ([sumber](https://www.ibm.com/think/topics/api)). Artikel ini berfokus pada web API karena jenis inilah yang menghubungkan aplikasi bisnis.

## Cara Kerja API

AWS menjelaskan arsitektur API dalam kaitan klien dan server. Aplikasi yang mengirim permintaan disebut klien, aplikasi yang mengirim respons disebut server ([sumber](https://aws.amazon.com/id/what-is/api/)). Pada web API, alurnya seperti ini:

1. Klien (aplikasi web, aplikasi mobile, atau sistem lain) mengirim request ke alamat tertentu yang disebut endpoint.
2. Request berisi metode HTTP, header (misalnya token akses), dan kadang body berisi data.
3. Server memeriksa apakah request valid dan klien punya hak akses.
4. Server menjalankan logika bisnis, misalnya membaca database atau membuat pesanan.
5. Server mengirim respons berisi kode status dan data, lalu klien menampilkannya ke pengguna.

IBM memberi contoh tombol "Pay with PayPal" di toko online: ketika pembeli mengklik tombol, terjadi panggilan API ke sistem pembayaran pihak ketiga, lalu hasilnya dikembalikan ke website toko. Bagi pengguna, seluruh pertukaran itu tidak terlihat, yang muncul hanya konfirmasi pembayaran berhasil ([sumber](https://www.ibm.com/think/topics/api)).

### Contoh Request dan Response

Berikut ilustrasi request untuk mengambil data satu pelanggan dari sebuah REST API (endpoint dan data bersifat contoh):

```http
GET /api/v1/customers/1024 HTTP/1.1
Host: api.contoh-toko.co.id
Authorization: Bearer <token-akses>
Accept: application/json
```

Respons dari server:

```json
{
  "id": 1024,
  "name": "Toko Sumber Rejeki",
  "city": "Bandung",
  "status": "active"
}
```

Klien tidak tahu database apa yang dipakai server, bagaimana tabelnya disusun, atau bahasa pemrograman apa yang menjalankannya. Klien cukup tahu kontraknya: kirim GET ke endpoint ini dengan token yang valid, lalu terima data dalam format JSON.

### Metode HTTP dan Kode Status

MDN mendokumentasikan metode request HTTP yang dipakai REST API untuk menyatakan aksi terhadap sebuah resource ([sumber](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Methods)):

| Metode | Fungsi menurut MDN | Contoh di aplikasi bisnis |
| --- | --- | --- |
| GET | Meminta representasi resource; hanya mengambil data | Mengambil daftar produk |
| POST | Mengirim data ke resource, dapat menyebabkan perubahan di server | Membuat pesanan baru |
| PUT | Mengganti seluruh representasi resource dengan data request | Mengganti data alamat pelanggan |
| PATCH | Menerapkan perubahan sebagian pada resource | Mengubah status pesanan saja |
| DELETE | Menghapus resource | Menghapus draf penawaran |

Server menjawab dengan kode status. MDN membaginya menjadi lima kelas: 100–199 respons informasional, 200–299 sukses, 300–399 pengalihan, 400–499 kesalahan klien, dan 500–599 kesalahan server ([sumber](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status)). Contohnya, 404 berarti resource tidak ditemukan dan 401 berarti klien belum terautentikasi.

## Jenis-Jenis API

API bisa dikelompokkan dari dua sisi: gaya arsitektur (cara berkomunikasi) dan hak akses (siapa yang boleh memakai).

### Berdasarkan Arsitektur dan Protokol

| Jenis | Ciri utama | Cocok untuk |
| --- | --- | --- |
| REST | Data diperlakukan sebagai resource dengan URI unik, memakai metode HTTP, bersifat stateless | Web API dan aplikasi mobile |
| SOAP | Protokol pesan berbasis XML dengan standar ketat, bisa berjalan di atas HTTP, SMTP, dan protokol lain | Sistem enterprise yang butuh standar formal, misalnya keuangan dan kesehatan |
| RPC (termasuk JSON-RPC dan gRPC) | Berorientasi aksi; klien memanggil fungsi di server seolah fungsi lokal | Komunikasi internal antar layanan |
| GraphQL | Klien menentukan sendiri data yang diminta lewat satu endpoint | Aplikasi dengan kebutuhan data klien yang beragam |
| WebSocket | Koneksi dua arah yang tetap terbuka | Fitur real-time seperti chat atau data langsung |

Sumber ciri di tabel: IBM ([sumber](https://www.ibm.com/think/topics/api)) dan AWS ([sumber](https://aws.amazon.com/id/what-is/api/)).

REST sendiri adalah gaya arsitektur yang dirumuskan Roy Fielding dalam disertasinya di University of California, Irvine pada tahun 2000 ([sumber](https://ics.uci.edu/~fielding/pubs/dissertation/top.htm)). IBM merangkum enam batasan REST: antarmuka seragam, pemisahan klien dan server, stateless, dapat di-cache, sistem berlapis, dan code on demand yang bersifat opsional ([sumber](https://www.ibm.com/think/topics/api)).

Menurut IBM, gRPC dikembangkan awalnya oleh Google, memakai format biner Protocol Buffers, dan berjalan di atas HTTP/2, sedangkan GraphQL dikembangkan Facebook pada 2012 ([sumber](https://www.ibm.com/think/topics/api)).

### Berdasarkan Hak Akses

AWS dan IBM membagi API menurut cakupan penggunaannya ([sumber](https://aws.amazon.com/id/what-is/api/)):

- API privat (internal): hanya dipakai di dalam perusahaan untuk menghubungkan sistem dan data internal.
- API publik: terbuka bagi developer mana pun; sebagian mewajibkan kunci API atau biaya.
- API partner: hanya dapat diakses mitra resmi, misalnya untuk pertukaran data B2B.
- API komposit: menggabungkan beberapa panggilan API untuk menangani satu kebutuhan. IBM menilainya lebih tepat disebut pola arsitektur daripada tingkat akses ([sumber](https://www.ibm.com/think/topics/api)).

## Fungsi dan Manfaat API untuk Bisnis

AWS menyebut empat keuntungan REST API: integrasi aplikasi baru dengan sistem yang sudah ada tanpa menulis semua fungsi dari awal, inovasi lewat perubahan di tingkat API tanpa menulis ulang seluruh kode, ekspansi ke berbagai platform, dan kemudahan pemeliharaan karena perubahan internal satu sistem tidak harus berdampak ke sistem lain ([sumber](https://aws.amazon.com/id/what-is/api/)).

Dalam bahasa operasional bisnis, manfaat itu terlihat seperti ini:

- Satu backend untuk banyak kanal. IBM mencatat organisasi dapat membangun fungsi backend sekali, lalu melayani web, iOS, dan Android lewat API, dan kanal baru bisa ditambah tanpa membangun ulang backend ([sumber](https://www.ibm.com/think/topics/api)).
- Data tersinkron antar sistem. Contoh IBM: jika alamat pelanggan diperbarui di CRM, perubahan itu dapat diteruskan otomatis ke sistem lain yang terhubung, termasuk ERP ([sumber](https://www.ibm.com/think/topics/api)).
- Memakai layanan pihak ketiga. Pembayaran, peta, pengiriman, dan model AI dapat dipasang lewat API tanpa membangunnya sendiri.
- Membuka data ke mitra secara terkontrol. Perusahaan logistik, misalnya, dapat membuka status pengiriman lewat API agar retailer menampilkannya di sistem mereka ([sumber](https://www.ibm.com/think/topics/api)).

## Contoh API dalam Kehidupan Sehari-hari dan Bisnis

| Situasi | Peran API |
| --- | --- |
| Aplikasi cuaca di ponsel | Mengambil data cuaca dari server penyedia data, seperti contoh BMKG dari AWS |
| Tombol bayar di toko online | Mengirim data transaksi ke penyedia pembayaran dan menerima status pembayaran |
| Peta lokasi toko di website | Menampilkan peta dari layanan pemetaan pihak ketiga |
| Dashboard penjualan | Menarik data pesanan dari aplikasi kasir atau marketplace ke satu laporan |
| CRM dan ERP | Menyinkronkan data pelanggan, pesanan, dan tagihan antar sistem |
| AI agent | Memanggil API atau server MCP untuk membaca dan mengubah data bisnis |

Ilustrasi (contoh fiktif): sebuah distributor di Jawa Barat mencatat pesanan dari tim sales di CRM, sementara stok dan faktur ada di ERP. Tanpa API, admin menyalin data pesanan secara manual ke ERP. Dengan API, CRM mengirim POST ke endpoint pesanan di ERP begitu pesanan disetujui, lalu ERP mengembalikan nomor faktur yang tersimpan kembali di CRM. Untuk memahami kedua sistem tersebut, baca [CRM adalah](/blog/crm-adalah) dan [ERP adalah](/blog/erp-adalah).

## API, Webhook, Middleware, dan Backend: Apa Bedanya?

| Istilah | Inti | Siapa yang memulai komunikasi |
| --- | --- | --- |
| API | Kontrak yang mendefinisikan apa yang bisa diminta dan apa yang dikembalikan | Klien mengirim request |
| Webhook | Notifikasi otomatis yang dikirim saat peristiwa tertentu terjadi | Server penyedia mengirim data ke URL penerima |
| Middleware | Lapisan perantara yang menjalankan, meneruskan, atau mengelola komunikasi | Bergantung pada jenisnya |
| Backend | Sisi server aplikasi yang menyimpan data dan menjalankan logika bisnis | Menyediakan API untuk diakses klien |

IBM menjelaskan bahwa webhook membalik model request dan response: bukan klien yang meminta data, melainkan server yang mendorong notifikasi ke klien ketika peristiwa tertentu terjadi ([sumber](https://www.ibm.com/think/topics/api)). Penjelasan lebih lengkap ada di artikel [middleware adalah](/blog/middleware-adalah), [backend adalah](/blog/backend-adalah), dan [frontend adalah](/blog/frontend-adalah). Cara memadukan API, webhook, dan ETL antar sistem dibahas di [integrasi sistem adalah](/blog/integrasi-sistem-adalah).

### API Gateway

IBM mendefinisikan API gateway sebagai lapisan software yang menjadi satu pintu masuk bagi klien untuk mengakses banyak layanan backend, dengan fungsi utama routing, autentikasi, rate limiting, dan monitoring ([sumber](https://www.ibm.com/think/topics/api)). API gateway adalah salah satu contoh middleware.

## Keamanan API

Endpoint API adalah pintu masuk ke data bisnis, sehingga keamanannya perlu dirancang sejak awal. AWS menyebut dua cara dasar mengamankan REST API: token autentikasi untuk memastikan pengguna sah dan punya hak akses, serta kunci API untuk mengidentifikasi aplikasi pemanggil. AWS juga mencatat kunci API tidak seaman token ([sumber](https://aws.amazon.com/id/what-is/api/)).

OWASP menerbitkan daftar OWASP Top 10 API Security Risks 2023. Tiga risiko teratasnya ([sumber](https://owasp.org/API-Security/editions/2023/en/0x11-t10/)):

1. API1:2023 Broken Object Level Authorization: endpoint menerima ID objek dari pengguna tanpa memeriksa apakah pengguna itu berhak atas objek tersebut.
2. API2:2023 Broken Authentication: mekanisme autentikasi yang salah implementasi sehingga penyerang dapat mengambil alih identitas pengguna lain.
3. API3:2023 Broken Object Property Level Authorization: tidak ada validasi otorisasi pada tingkat properti objek, sehingga data bocor atau bisa dimanipulasi.

Daftar yang sama juga memuat risiko konsumsi sumber daya tanpa batas (API4) yang dapat berujung pada penolakan layanan atau naiknya biaya operasional, serta risiko terlalu percaya pada data dari API pihak ketiga (API10) ([sumber](https://owasp.org/API-Security/editions/2023/en/0x11-t10/)). Untuk aplikasi Next.js, praktik pengamanan dan deployment dibahas di [keamanan dan deployment Next.js](/blog/nextjs-security-deployment).

## Cara Membangun atau Mengintegrasikan API

AWS menguraikan lima langkah menghasilkan desain API: merencanakan dengan spesifikasi seperti OpenAPI, membangun prototipe, menguji, mendokumentasikan, dan memasarkan bila API ditujukan untuk pihak luar ([sumber](https://aws.amazon.com/id/what-is/api/)). OpenAPI Specification sendiri adalah standar untuk mendeskripsikan HTTP API yang dikelola OpenAPI Initiative ([sumber](https://www.openapis.org/)).

Checklist berikut adalah panduan internal CDS sebelum memulai proyek API atau integrasi:

- Tentukan data dan aksi yang benar-benar dibutuhkan. Jangan membuka seluruh tabel database hanya karena mudah.
- Tulis kontraknya dulu: daftar endpoint, format request dan respons, serta kode error.
- Pilih autentikasi dan otorisasi: siapa boleh membaca, siapa boleh mengubah, dan cek hak akses di setiap objek.
- Rencanakan versi API (misalnya /v1) agar perubahan besar tidak memutus integrasi yang sudah berjalan.
- Siapkan batas jumlah request, logging, dan monitoring sejak rilis pertama.
- Uji integrasi dengan data nyata sebelum go-live, termasuk skenario gagal. Proses pengujian bersama pengguna dibahas di [UAT adalah](/blog/uat-adalah).
- Anggarkan pemeliharaan: API pihak ketiga dapat berubah versi, dan integrasi perlu dipantau. Lihat [biaya maintenance aplikasi](/blog/biaya-maintenance-aplikasi).

### API dan AI Agent

IBM mencatat AI agent juga memakai API untuk mengakses layanan, dan Model Context Protocol (MCP) hadir sebagai standar terbuka yang berada di atas API yang sudah ada agar agent dapat menemukan dan memakai tool secara seragam ([sumber](https://www.ibm.com/think/topics/api)). Contohnya [Zetta CRM](/incubating/zetta-crm), produk inkubasi CDS berupa server MCP berbasis Go untuk AI agent, dengan endpoint POST /mcp dan akses yang dijaga API key. Pembahasan arsitekturnya ada di [MCP server sebagai backend AI agent](/blog/mcp-server-backend-ai-agent-aman-bisnis).

## FAQ Seputar API

### API adalah apa dalam bahasa sederhana?

API adalah aturan main yang memungkinkan dua aplikasi bertukar data. Satu aplikasi mengirim permintaan sesuai format yang disepakati, aplikasi lain menjawab dengan data atau hasil proses, tanpa membuka isi sistem internalnya.

### Apa kepanjangan API?

API adalah singkatan dari Application Programming Interface atau antarmuka pemrograman aplikasi ([sumber](https://aws.amazon.com/id/what-is/api/)).

### Apa contoh API yang ditemui sehari-hari?

Aplikasi cuaca yang mengambil data dari server penyedia, tombol pembayaran di toko online, peta di website, dan login memakai akun pihak ketiga. Semuanya memakai API untuk meminta data atau layanan dari sistem lain.

### Apa itu REST API?

REST API adalah API yang mengikuti gaya arsitektur REST: data diperlakukan sebagai resource dengan alamat unik, diakses lewat metode HTTP seperti GET dan POST, dan server tidak menyimpan state klien di antara request ([sumber](https://aws.amazon.com/id/what-is/api/)).

### Apa perbedaan API dan webhook?

Pada API, klien yang memulai request. Pada webhook, sistem penyedia yang mengirim notifikasi ke URL penerima begitu sebuah peristiwa terjadi ([sumber](https://www.ibm.com/think/topics/api)). Integrasi bisnis kerap memakai keduanya bersamaan.

### Apakah API aman?

API aman jika dirancang dengan autentikasi, otorisasi per objek, enkripsi, validasi input, dan pembatasan request. OWASP API Security Top 10 2023 dapat dipakai sebagai daftar periksa risiko ([sumber](https://owasp.org/API-Security/editions/2023/en/0x11-t10/)).

## Butuh API atau Integrasi untuk Sistem Bisnis Anda?

Jika aplikasi kasir, CRM, ERP, atau marketplace Anda belum saling terhubung, tim CDS bisa membantu merancang kontrak API, membangun backend-nya, dan mengintegrasikan sistem yang sudah ada. Layanan [jasa pembuatan software custom](/services/software) CDS mencakup aplikasi web, mobile, dashboard internal, CMS, dan integrasi API, dengan sprint dua minggu dan kode yang diserahkan penuh. Jika arsitekturnya belum jelas, mulai dari [konsultasi arsitektur IT](/services/consulting), atau lihat dulu [karya CDS](/works).


---

*Markdown version of https://www.ciptadusa.com/blog/api-adalah — generated for AI agents and LLM crawlers.*