Jika Anda pernah berbelanja di etalase kustom yang tidak terlihat seperti templat standar, kemungkinan besar API perdagangan tanpa kepala (headless commerce API) adalah yang bekerja di baliknya. API perdagangan tanpa kepala adalah antarmuka yang diekspos oleh backend perdagangan sehingga etalase apa pun dapat membaca produk, membuat keranjang belanja, dan melakukan pemesanan tanpa terikat pada tema bawaan. Penjelasan ini mencakup apa artinya, bagaimana kaitannya dengan perdagangan yang dapat disusun (composable commerce) dan MACH, serta mengapa tim etalase dan mitra Anda sangat bergantung pada kontrak API tersebut. Ini dibangun di atas gagasan bahwa perangkat lunak beralih ke tanpa kepala (headless) dan API Anda kini adalah produknya.
Apa Arti “Tanpa Kepala” dalam Perdagangan
Platform perdagangan tradisional dikirim sebagai satu kesatuan. Katalog produk, keranjang belanja, proses pembayaran, dan halaman HTML yang menampilkannya semuanya berada dalam sistem yang sama. Anda memberi tema, menyesuaikannya, dan meluncurkannya.
Perdagangan tanpa kepala memisahkan itu menjadi dua. Bagian backend, sering disebut mesin perdagangan, menyimpan katalog, harga, inventaris, keranjang belanja, dan logika pesanan. Bagian frontend, etalase Anda, menjadi aplikasi terpisah yang Anda bangun sesuka hati. Satu-satunya yang menghubungkannya adalah API.
Jadi "kepala" adalah lapisan presentasi. Beralih ke tanpa kepala berarti menghapus kepala yang tetap dan mengekspos bagian tubuh, logika perdagangan, melalui API. Situs React, aplikasi seluler asli, layar kulkas pintar, atau asisten suara semuanya dapat berkomunikasi dengan backend yang sama karena semuanya berbicara bahasa API yang sama.
Dekopling itu adalah intinya. Tim frontend Anda memilih kerangka kerja mereka sendiri dan meluncurkan sesuai jadwal mereka sendiri. Tim backend memiliki aturan perdagangan. API adalah batas di antara mereka.
Konsekuensinya adalah Anda menanggung lebih banyak pekerjaan. Platform tradisional memberi Anda toko yang berfungsi langsung. Beralih ke tanpa kepala berarti Anda membangun dan menghosting etalase sendiri, sehingga fleksibilitas datang dengan biaya rekayasa. Tim memilih tanpa kepala ketika tema standar tidak dapat memberikan pengalaman yang mereka butuhkan, atau ketika mereka ingin melayani beberapa saluran dari satu backend.
Tanpa Kepala (Headless) vs. Dapat Disusun (Composable) vs. MACH
Ketiga istilah ini sering digunakan secara bergantian, tetapi mereka menggambarkan cakupan yang berbeda. Berikut adalah penjelasannya secara jujur.
| Istilah | Apa yang dijelaskan | Cakupan |
|---|---|---|
| Perdagangan tanpa kepala | Frontend terlepas dari satu backend perdagangan, terhubung oleh API | Satu backend, satu atau banyak frontend |
| Perdagangan yang dapat disusun (Composable commerce) | Seluruh tumpukan dipecah menjadi layanan terbaik di kelasnya yang dapat dipertukarkan (katalog, pencarian, pembayaran, PIM, OMS) | Banyak layanan independen dirakit bersama |
| MACH | Sederet prinsip arsitektur yang cenderung diikuti oleh tumpukan yang dapat disusun | Sebuah filosofi, bukan produk |
Tanpa kepala adalah kasus yang sempit. Anda bisa tanpa kepala dengan satu backend monolitik, selama etalase berkomunikasi dengannya melalui API.
Perdagangan yang dapat disusun (composable commerce) melangkah lebih jauh. Alih-alih satu backend, Anda merakit layanan independen dan memilih alat terbaik untuk setiap tugas. Pencarian dari satu vendor, pembayaran dari vendor lain, manajer informasi produk terpisah. Masing-masing adalah layanannya sendiri dengan API-nya sendiri, dan Anda menyusunnya menjadi satu pengalaman.
MACH adalah kumpulan prinsip di balik sebagian besar tumpukan yang dapat disusun. Menurut MACH Alliance, sebuah kelompok industri yang dibentuk pada tahun 2020, MACH adalah singkatan dari Microservices (Layanan Mikro), API-first (API-utamakan), Cloud-native SaaS (SaaS asli cloud), dan Headless (Tanpa Kepala). Perhatikan bahwa API-first berada tepat di tengah. Dalam dunia MACH, API bukanlah fitur sampingan. Itu satu-satunya cara komponen-komponen saling berkomunikasi, yang merupakan alasan yang sama di balik memperlakukan API Anda sebagai produk.
Apa yang Sebenarnya Diekspos oleh API Perdagangan Tanpa Kepala
Bentuk persisnya bervariasi per platform, tetapi sebagian besar API perdagangan tanpa kepala mencakup tugas inti yang sama:
- Katalog dan produk. Membaca produk, varian, koleksi, dan media agar etalase dapat menampilkan daftar dan halaman detail.
- Pencarian dan penjelajahan. Mengkueri, memfilter, dan mengurutkan katalog.
- Keranjang dan pembayaran. Membuat keranjang belanja, menambah dan menghapus item baris, menerapkan diskon, dan melanjutkan ke pembayaran.
- Pelanggan. Masuk, mengelola akun, dan melacak riwayat pesanan.
- Inventaris dan harga. Menampilkan tingkat stok dan harga yang tepat untuk konteks yang tepat.
Beberapa platform memisahkan ini menjadi API etalase yang menghadap publik dan API admin terpisah untuk pekerjaan back-office. API etalase lebih banyak membaca dan berinteraksi dengan pelanggan. API admin menangani pengeditan katalog, manajemen pesanan, dan konfigurasi.
Protokol juga penting. Banyak API perdagangan tanpa kepala adalah GraphQL, yang memungkinkan etalase meminta bidang yang persis dibutuhkan dalam satu panggilan, yang sangat cocok untuk tampilan produk dan keranjang. Tetapi banyak API perdagangan tanpa kepala menggunakan REST, dan beberapa platform menawarkan keduanya. Jika Anda mempertimbangkan komprominya, lihat REST vs GraphQL.
Platform Utama
Ruang perdagangan tanpa kepala secara kasar terbagi menjadi mesin SaaS dan mesin sumber terbuka. Beberapa nama yang akan Anda temui:
- commercetools. Anggota pendiri MACH Alliance dan salah satu platform perdagangan yang dapat disusun yang paling sering disebut. Berbasis API-first dan cloud-native berdasarkan desain.
- Shopify. Menawarkan pembangunan tanpa kepala melalui Storefront API-nya, dengan Hydrogen sebagai kerangka kerja React untuk menggunakannya. Jika Anda sudah berada di ekosistem Shopify, tutorial API Shopify kami adalah titik awal yang baik.
- BigCommerce. Mendukung mode tanpa kepala dengan GraphQL Storefront dan Checkout API di atas katalognya. Lihat panduan kami untuk menggunakan API BigCommerce.
- Saleor. Mesin sumber terbuka, berbasis GraphQL-first yang dibangun di atas Python dan Django.
- Medusa. Mesin sumber terbuka yang dibangun di atas Node.js dan TypeScript, populer di kalangan tim JavaScript yang menginginkan kontrol backend penuh.
Verifikasi spesifikasi platform sebelum Anda berkomitmen, karena harga, model hosting, dan cakupan API dapat berubah. Pola di antara semuanya sama: mesin mengekspos logika perdagangan melalui API, dan Anda membangun "kepala" (frontend).
Mengapa Tim Bergantung pada Kontrak API Perdagangan
Setelah etalase didekopling, API berhenti menjadi pipa penghubung dan menjadi kesepakatan yang menjadi dasar pembangunan semua orang. Di sinilah headless menjadi nyata.
Tim frontend Anda tidak dapat meluncurkan halaman produk sampai mereka mengetahui bentuk respons produk yang tepat. Integrasi mitra Anda, aplikasi loyalitas, layanan pajak, umpan pasar, semuanya terhubung ke endpoint yang sama. Tim seluler menggunakan kontrak yang sama dengan tim web. Jika bentuk respons berubah tanpa peringatan, setiap konsumen tersebut dapat rusak sekaligus.
Itulah risiko dan peluangnya. Kontrak API perdagangan yang jelas, stabil, dan terdokumentasi dengan baik memungkinkan tim independen bergerak cepat tanpa saling mengganggu. Kontrak yang samar atau berubah-ubah mengubah setiap rilis menjadi perebutan koordinasi. Kontrak adalah produk, jadi ia pantas mendapatkan perhatian yang sama seperti etalase itu sendiri, termasuk pengujian kontrak untuk menangkap perubahan yang merusak sebelum diluncurkan.
Pemberian versi juga merupakan bagian dari kesepakatan. Ketika Anda perlu mengubah respons produk atau mengganti nama bidang, Anda tidak bisa begitu saja mengedit endpoint dan berharap. Konsumen yang tidak Anda kendalikan sedang membacanya. Jadi tim tanpa kepala memperlakukan kontrak sebagai komitmen publik: perubahan aditif jika memungkinkan, jendela penghentian yang jelas, dan pengujian yang menandai setiap hal yang merusak sebelum mencapai integrasi mitra.
Di Mana Apidog Cocok
Apidog tidak menjalankan toko Anda. Ini bukan mesin perdagangan, CMS, atau gateway, dan tidak membuat tumpukan Anda tanpa kepala atau dapat disusun. Apa yang dilakukannya adalah memiliki pilar API-first dari semua ini: lapisan tempat Anda merancang, menguji, mengejek (mock), dan mendokumentasikan kontrak yang menjadi sandaran segalanya.
Itu cocok dengan rapi ke pekerjaan perdagangan tanpa kepala:
- Rancang kontrak terlebih dahulu. Model API etalase atau admin sebagai spesifikasi OpenAPI di Apidog sebelum kode ada, sehingga frontend dan backend menyetujui bentuknya di awal.
- Ejek (Mock) sebelum backend siap. Jalankan server tiruan (mock server) dari spesifikasi agar tim etalase Anda dapat membangun berdasarkan respons produk dan keranjang yang realistis sementara mesin perdagangan masih dalam proses pengerjaan. Itu adalah janji dekopling yang dibuat praktis, dan Anda dapat membaca lebih lanjut di penjelasan API tiruan (mock API) kami.
- Uji kontrak di CI. Apidog CLI menjalankan pengujian API Anda tanpa GUI, eksekusi pengujian tanpa kepala yang cocok dengan pipeline. Ini adalah kesamaan konseptual yang sejati dengan perdagangan tanpa kepala: tidak diperlukan frontend, hanya kontrak yang diverifikasi.
- Dokumentasikan untuk mitra. Dokumen interaktif yang dibuat secara otomatis memberikan tim etalase dan mitra Anda satu sumber kebenaran untuk API yang mereka integrasikan.
Untuk melihat lebih dalam mengapa ini penting setelah API menjadi satu-satunya antarmuka, lihat perangkat lunak beralih ke tanpa kepala dan API Anda kini adalah produknya. Jika Anda ingin mencoba alurnya, unduh Apidog dan impor spesifikasi yang ada.
Pertanyaan yang Sering Diajukan
Apakah perdagangan tanpa kepala sama dengan perdagangan yang dapat disusun (composable commerce)?
Tidak. Perdagangan tanpa kepala memisahkan etalase dari satu backend perdagangan melalui API. Perdagangan yang dapat disusun melangkah lebih jauh dan merakit banyak layanan terbaik di kelasnya yang independen, masing-masing dengan API-nya sendiri, menjadi satu pengalaman. Setiap tumpukan yang dapat disusun adalah tanpa kepala, tetapi pengaturan tanpa kepala dengan satu backend monolitik belum tentu dapat disusun.
Apakah saya memerlukan GraphQL untuk API perdagangan tanpa kepala?
Tidak. GraphQL umum karena memungkinkan etalase meminta bidang yang persis dibutuhkan dalam satu panggilan, yang sangat cocok untuk tampilan produk dan keranjang. Tetapi banyak API perdagangan tanpa kepala menggunakan REST, dan beberapa platform menawarkan keduanya. Protokol kurang penting dibandingkan kontrak yang stabil dan terdokumentasi.
Bisakah saya menguji API perdagangan tanpa kepala sebelum backend dibangun?
Ya, dan itu adalah salah satu alasan utama untuk mendahulukan desain. Jika Anda memodelkan kontrak API sebagai spesifikasi, Anda dapat menghasilkan server tiruan (mock server) yang mengembalikan respons realistis. Tim etalase Anda membangun dan menguji terhadap tiruan sementara mesin perdagangan masih dalam proses, lalu beralih ke endpoint yang sebenarnya nanti.
Apa itu MACH Alliance?
MACH Alliance adalah kelompok industri yang dibentuk pada tahun 2020 untuk mempromosikan tumpukan teknologi terbuka, terbaik di kelasnya yang dibangun berdasarkan prinsip Microservices (Layanan Mikro), API-first (API-utamakan), Cloud-native SaaS (SaaS asli cloud), dan Headless (Tanpa Kepala). Vendor seperti commercetools adalah anggota pendiri. MACH adalah seperangkat prinsip arsitektur, bukan produk tunggal yang Anda beli.
Kontrak adalah Toko
Perdagangan tanpa kepala memindahkan nilai dari tema ke API. Setelah etalase didekopling, API perdagangan adalah apa yang sebenarnya dibangun oleh tim frontend, seluler, dan mitra Anda. Perdagangan yang dapat disusun dan MACH mendorong hal itu lebih jauh dengan menjadikan API-first sebagai prinsip inti daripada sekadar fitur tambahan yang menyenangkan.
Semua itu tidak bergantung pada Apidog, tetapi kualitas kontrak memang diuntungkan dari tempat untuk merancang, mengejek (mock), menguji, dan mendokumentasikannya. Jika ke sanalah proyek tanpa kepala Anda menuju, Apidog memberi Anda lapisan itu tanpa berpura-pura menjadi mesin perdagangan di bawahnya.