Seiring bertumbuhnya organisasi teknologi enterprise, sistem perangkat lunak umumnya dipecah menjadi puluhan layanan mikro (microservices) yang dimiliki oleh tim-tim independen. Di sisi frontend, berbagai klien (aplikasi mobile iOS/Android, dashboard internal, portal pelanggan web, dan integrasi API pihak ketiga) membutuhkan data gabungan dari berbagai domain tersebut.
Terdapat dua paradigma arsitektur utama untuk menjembatani komunikasi antara berbagai frontend dan backend terdistribusi: REST API Gateway / Backends for Frontends (BFF) dan Distributed GraphQL Federation.
REST API Gateway (BFF) vs GraphQL Federation:
Model REST API Gateway:
Frontend Klien ──► [API Gateway (Kong / NGINX)] ──► Rute /api/v1/orders ──► Service Order
└──► [BFF Aggregation Service] ──► Rute /api/v1/users ──► Service User
(BFF Menulis Kode Gabungan Khusus Tiap Klien)
Model GraphQL Federation (Supergraph):
Frontend Klien ──► [Router Federation (Apollo / Hive)] ──► Subgraph Order
(Satu Endpoint Tunggal /graphql) ──► Subgraph User
(Query Planner Mengurai Otomatis!) ──► Subgraph Payment
REST API Gateway dan Pola Backends for Frontends (BFF) #
Pada pendekatan REST tradisional, sebuah API Gateway terpusat bertindak sebagai reverse proxy yang mengarahkan panggilan HTTP ke microservices yang sesuai berdasarkan path URL.
Untuk mengatasi masalah under-fetching (klien harus memanggil 5 endpoint berbeda untuk merender satu halaman transaksi), tim biasanya membangun lapisan Backend for Frontend (BFF). BFF adalah server perantara yang melakukan agregasi data dan mengembalikan JSON siap pakai untuk antarmuka tertentu.
Kelebihan REST API Gateway:
- Infrastruktur Caching Sederhana: Memanfaatkan caching HTTP standar (RFC 9111) di tingkat browser dan Edge CDN (Cloudflare/Fastly) dengan metode GET, header
ETag, danCache-Control. - Debugging Transparan: Setiap pemanggilan jaringan dapat dipantau langsung di browser network tab atau log akses NGINX dengan kode status HTTP semantik (200, 404, 502).
- Protokol Matang: Didukung penuh oleh seluruh ekosistem tooling, SDK, dan API gateway enterprise (Kong, Apigee, Envoy).
Kekurangan REST API Gateway:
- Over-fetching & Under-fetching: Klien sering menerima properti JSON yang tidak dibutuhkan atau terpaksa membuat panggilan berantai.
- Biaya Pemeliharaan BFF Tinggi: Setiap perubahan tampilan UI membutuhkan perubahan endpoint kustom di lapisan BFF.
GraphQL Federation: Menyatukan Schema Terdistribusi #
GraphQL Federation membagi skema GraphQL menjadi beberapa Subgraph independen yang masing-masing dikelola oleh tim pemilik domain layanan. Sebuah Federation Router (misalnya Apollo Router berbasis Rust atau Hive Gateway) mengombinasikan subgraph-subgraph tersebut menjadi satu Supergraph Schema terpadu.
Klien hanya berinteraksi dengan satu endpoint /graphql. Klien dapat meminta data dari lima domain berbeda dalam satu query, dan Router Federation secara otomatis menyusun rencana eksekusi (query plan) untuk mengambil data secara paralel ke subgraph terkait.
Contoh Deklarasi Subgraph dengan Directive Federation v2 #
Setiap subgraph mendefinisikan tipe data miliknya dan dapat memperluas entitas dari domain lain menggunakan direktif federasi:
# Subgraph Produk (Dikelola oleh Tim Katalog)
type Product @key(fields: "id") {
id: ID!
name: String!
price: Int!
sku: String!
}
# Subgraph Ulasan (Dikelola oleh Tim Customer Engagement)
# Memperluas tipe Product tanpa harus menyalin database katalog
extend type Product @key(fields: "id") {
id: ID! @external
reviews: [Review!]!
averageRating: Float!
}
type Review {
id: ID!
comment: String!
rating: Int!
}
Ketika klien mengirimkan query:
query GetProductDetails {
product(id: "prod-42") {
name
price
averageRating
reviews {
comment
rating
}
}
}
Router Federation secara otomatis:
- Memanggil Subgraph Produk untuk mengambil
namedanprice. - Mengirimkan array ID produk ke Subgraph Ulasan untuk mengambil
averageRatingdanreviews. - Menggabungkan kedua payload JSON menjadi satu respons utuh bagi klien.
Tantangan Teknis GraphQL Federation: Caching dan N+1 Problem #
Meskipun memberikan fleksibilitas luar biasa di sisi antarmuka, GraphQL Federation membawa kompleksitas operasional yang wajib diantisipasi:
- Kompleksitas Caching HTTP:
Hampir seluruh query GraphQL dikirim melalui metode HTTPPOST, yang secara bawaan tidak di-cache oleh browser atau CDN publik. Untuk mengatasinya, organisasi wajib menerapkan Automatic Persisted Queries (APQ), di mana hash query didaftarkan terlebih dahulu dan dikirim melalui HTTP GET ke CDN tepi. - Masalah N+1 Query:
Jika resolver subgraph tidak dioptimalkan, Router dapat mengeksekusi puluhan query database terpisah untuk entitas bersarang. Solusinya adalah penggunaan pustaka DataLoader untuk mengelompokkan (batching) ID entitas ke dalam satu queryWHERE id IN (...). - Overhead CPU Router:
Proses parsing dokumen GraphQL, validasi AST, pembuatan query plan, dan penggabungan respons JSON memerlukan komputasi CPU intensif dibanding reverse proxy REST murni.
Matriks Perbandingan Keputusan Arsitektur #
| Kriteria Evaluasi | REST API Gateway / BFF | GraphQL Federation |
|---|---|---|
| Titik Kontak Klien | Banyak endpoint REST (/api/v1/...) | Satu endpoint Supergraph (/graphql) |
| Efisiensi Payload Jaringan | Rentan over-fetching | Sangat presisi (klien hanya meminta yang perlu) |
| Caching di Tingkat Edge CDN | Sangat mudah (header HTTP GET standar) | Memerlukan Persisted Queries (APQ) |
| Kurva Pembelajaran Tim | Rendah (standar umum web) | Menengah ke Tinggi (spesifikasi federasi & skema) |
| Tata Kelola Kontrak API | OpenAPI / Swagger docs terpisah | Schema Registry terpusat dengan deteksi breaking change |
| Latensi Dasar Per Request | 0.5 - 2 ms (overhead proxy murni) | 2 - 8 ms (overhead parsing AST & planning) |
| Skalabilitas Tim | Setiap tim membuat controller sendiri | Tim berkontribusi pada Subgraph masing-masing |
Panduan Rekomendasi Pemilihan #
- Pilih GraphQL Federation jika organisasi memiliki beberapa klien antarmuka dengan kebutuhan tampilan yang sangat dinamis (misalnya aplikasi web super-app, iOS, dan Android), memiliki lebih dari 5 tim pengembang domain independen, dan ingin menghilangkan ketergantungan pembuatan endpoint BFF berulang.
- Pilih REST API Gateway jika beban kerja didominasi oleh operasi streaming data bervolume tinggi, integrasi publik B2B ke pihak ketiga yang membutuhkan kesederhanaan webhook/REST, atau sistem yang sangat mengandalkan caching agregasi publik di Edge CDN tanpa kompleksitas runtime tambahan.
