Walse

Posted on Apr 27 • Originally published at apidog.com

Apa Itu Zuplo API Gateway?

Sebagian besar gateway API masih terasa seperti produk tahun 2014: menulis YAML, mengelola control plane, dan mengandalkan akses cluster untuk deployment. Zuplo mengubah model tersebut. Ini adalah gateway API edge-native, dapat diprogram, rute terkelola di Git, kebijakan berbasis TypeScript, dan setiap commit didistribusikan ke 300+ lokasi global dalam hitungan detik.

Coba Apidog hari ini

Panduan ini membahas cara kerja gateway API Zuplo, perbedaannya dari Kong dan AWS API Gateway, harga, serta langkah cepat meluncurkan gateway pertama Anda dalam waktu kurang dari 30 menit. Disertakan contoh kode routing, autentikasi, pembatasan rate, serta pengujian endpoint menggunakan Apidog sebelum production.

Zuplo masuk kategori API Gateway bersama Kong, Apigee, dan AWS API Gateway. Poin utama: developer dapat menulis kode asli, operasional tetap managed, dan produk punya lapisan monetisasi siap pakai. Postingan ini mengupas alur kerja dan kompromi nyatanya.

TL;DR

Zuplo adalah gateway API edge-native, fully-managed, menjalankan rute pada 300+ edge Cloudflare, latensi <50 ms, tanpa cold start.
Konfigurasi berbasis GitOps: semua di repo Git, deployment via CI/CD, bukan UI.
Kebijakan dalam TypeScript—bukan YAML atau Lua—dengan dukungan IDE penuh.
Free tier: 100 ribu request/bulan, unlimited environment, API key, dan portal developer.
Built-in: autentikasi API key, JWT, OAuth2, rate limiting, validasi, portal developer otomatis, monetisasi Stripe.
Mendukung MCP Server Handler; expose rute gateway ke Claude, Codex, Cursor, dll.
Uji semua rute Zuplo dengan Apidog sebelum production.

Apa itu Zuplo?

Zuplo adalah platform manajemen API yang mengutamakan kode, edge, dan Git. Semua berjalan fully-managed di edge Cloudflare; satu deployment langsung tersebar di 300+ datacenter tanpa provisioning.

Tidak seperti gateway lain yang menyimpan konfigurasi YAML di control plane, Zuplo menganggap gateway Anda sebagai proyek TypeScript. File routes.oas.json mendeskripsikan endpoint, modul TypeScript menangani logika kustom, dan file konfigurasi untuk kebijakan. Push ke GitHub, platform akan build, validasi, dan deploy otomatis.

Support: REST, GraphQL, gRPC, WebSockets, SOAP. SOC 2 Tipe II, backend AWS/Azure/GCP, opsi self-hosted Kubernetes untuk kebutuhan residensi data. Harga mulai gratis, scaling berdasarkan request, bukan seat. Rinciannya di halaman harga Zuplo.

Mengapa Developer Memilih Zuplo daripada Kong, Apigee, dan AWS API Gateway

Setiap gateway punya karakteristik:

Kong: open-source, kontrol penuh, perlu skill Lua.
Apigee: enterprise, analytic mendalam, learning curve curam.
AWS API Gateway: default di AWS, tanpa portal developer, cold start Lambda nyata.

Zuplo menyasar tim kecil yang butuh fitur enterprise tanpa overhead platform engineering.

Perbedaan spesifik:

Kode, bukan YAML. Rate limit di Zuplo: 3 baris TypeScript. Di Kong: 15 baris YAML & plugin. Kalau Anda biasa TypeScript/JavaScript, konfigurasi Zuplo terasa natural.
Portal developer built-in. Di Kong hanya enterprise. Apigee perlu effort branding. Zuplo generate portal dari OpenAPI di semua paket.
GitOps by default. Setiap perubahan = pull request + audit log + git revert. Tidak ada tracking klik UI.
Edge-native, no cold start. Di Cloudflare Workers, request langsung ke edge terdekat, startup dalam ms. AWS API Gateway + Lambda = cold start 100–800 ms.

Jika sudah nyaman di Kong/Apigee, migrasi jarang worth. Jika butuh solusi baru atau gateway Anda bermasalah, workflow Zuplo jelas lebih baik.

Fitur Inti Gateway API Zuplo

Programabilitas TypeScript-first

Kebijakan (policy) didefinisikan dalam file TypeScript di samping rute Anda. Fungsi menerima request, bisa mengubah/menghentikan, dan mengembalikan request/response. Semua toolchain TypeScript didukung.

Contoh: hapus header internal pada setiap response:

import { ZuploRequest, ZuploContext } from "@zuplo/runtime";

export default async function (
  response: Response,
  request: ZuploRequest,
  context: ZuploContext,
) {
  response.headers.delete("x-internal-trace-id");
  return response;
}

Letakkan di modules/strip-internal-header.ts, referensikan di rute, push ke Git—langsung aktif.

60+ Kebijakan Bawaan

Mayoritas kebutuhan dasar (API key auth, JWT, OAuth 2.0, rate limit, validasi schema, CORS, allow list IP, transformasi request, integrasi upstream) sudah tersedia. Cukup edit definisi rute, tanpa coding baru untuk kasus standar.

Portal Developer Otomatis

Arahkan ke OpenAPI spec, langsung dapat situs dokumentasi lengkap + konsol try-it interaktif + code sample (cURL, JS, Python, Go) + API key self-service. End-user bisa signup, generate key, dan akses API tanpa intervensi manual.

Monetisasi API Bawaan

Integrasi Stripe tersedia. Definisikan paket (free, pro, enterprise), connect Stripe, portal handle checkout & subscription. Tidak perlu bangun billing sendiri.

MCP Server Handler untuk Agen AI

Expose OpenAPI Anda via MCP Server Handler agar bisa dipanggil Claude, OpenAI Codex, Cursor, dll. Semua kebijakan auth & rate limit tetap berlaku. Lihat panduan MCP Zuplo.

Deployment Edge, Latensi <50 ms

Semua gateway di-deploy ke 300+ edge Cloudflare. User di mana pun akan kena edge terdekat—tanpa konfigurasi tambahan.

Cara Kerja Zuplo Secara Internal

Request masuk ke edge terdekat, melewati pipeline berikut:

Pencocokan rute: URL & method dicocokkan ke routes.oas.json.
Kebijakan masuk: Auth, rate limit, validasi, dll berjalan berurutan.
Handler: Proxy ke upstream, return statis, TypeScript custom, atau MCP Handler.
Kebijakan keluar: Transformasi response, hapus header, dll.
Response: Kembali ke klien, log & metrics dikirim ke observabilitas Zuplo atau provider Anda.

Semuanya berjalan di Cloudflare Worker, sehingga latensi rendah & tidak ada idle cost.

Menyiapkan Gateway Zuplo Pertama Anda

Bisa selesai dalam 30 menit. Langkahnya:

Daftar di zuplo.com, buat proyek baru, integrasikan dengan GitHub.
Impor OpenAPI spec (jika sudah ada). Setiap operasi jadi rute. Jika belum ada, sketch di UI lalu ekspor spec.
Tambah kebijakan autentikasi API key: Tambahkan policy api-key-inbound di editor rute. Zuplo otomatis buat database konsumen & UI key publishing.
Tambah rate limit: Masukkan policy rate-limit-inbound (misal, 100 request/menit per API key). Satu blok JSON di rute.
Deploy: Push ke branch, Zuplo build preview environment dengan URL unik. Merge untuk production.
Uji gateway: Pakai Apidog untuk request ke URL gateway dengan API key valid/invalid, rate limit terlampaui, payload error. Inspector response visual memudahkan verifikasi policy.

Proyek pertama deploy dalam hitungan menit. Tantangan utama: penamaan rute & penempatan logika custom.

Menulis Kebijakan Custom di TypeScript

Untuk kebutuhan unik, tulis kebijakan custom. Contoh enrich request dengan data user internal sebelum ke origin:

import { ZuploRequest, ZuploContext } from "@zuplo/runtime";

interface UserContext {
  userId: string;
  plan: "free" | "pro" | "enterprise";
}

export default async function (
  request: ZuploRequest,
  context: ZuploContext,
): Promise<ZuploRequest | Response> {
  const apiKey = request.user?.sub;
  if (!apiKey) {
    return new Response("Unauthorized", { status: 401 });
  }

  const lookupUrl = `https://internal.example.com/users/${apiKey}`;
  const userResponse = await fetch(lookupUrl, {
    headers: { authorization: `Bearer ${context.environment.INTERNAL_TOKEN}` },
  });

  if (!userResponse.ok) {
    return new Response("User lookup failed", { status: 502 });
  }

  const user = (await userResponse.json()) as UserContext;
  request.headers.set("x-user-id", user.userId);
  request.headers.set("x-user-plan", user.plan);
  return request;
}

Kebijakan adalah fungsi async biasa, mudah di-unit test.
Variabel environment diakses via context.environment, type-safe.
Return Response langsung menghentikan pipeline, cocok untuk error/auth reject.

Harga Zuplo di Tahun 2026

Tiga paket utama:

Gratis, $0/bulan: 100 ribu request/bulan, unlimited environment/API key/portal, 1 GB egress, 300+ edge, 2 developer. Cocok untuk traffic produksi awal.
Builder, $25/bulan: Hingga 1 juta request/bulan, 2 custom domain, egress 1 GB/100 ribu request, $100/100 ribu request ekstra, support komunitas.
Enterprise, harga custom mulai $1.000/bulan: Request & domain unlimited, SLA hingga 99,999%, integrasi GitHub Enterprise, 24/7 support opsional, SSO, RBAC, observabilitas add-on.

Produk AI Gateway & Developer Portal punya tier sendiri, termasuk portal open-source self-hosted. Cek halaman harga Zuplo untuk detail terbaru.

Sebagai perbandingan: AWS API Gateway $3.50/juta request REST, plus data transfer & biaya Lambda. Kong enterprise biasanya di atas $1.000. Free tier Zuplo sangat layak untuk early-stage.

Kapan Zuplo Pilihan Tepat (dan Kapan Tidak)

Cocok jika:

Ingin gateway managed, tidak ingin run Kong di Kubernetes.
Tim terbiasa TypeScript/JavaScript.
Butuh portal developer tanpa vendor tambahan.
Perlu monetisasi API dengan Stripe.
Ingin expose API ke agen AI via MCP.
Traffic global, latency edge penting.

Tidak cocok jika:

Butuh kontrol penuh open-source (pilih Kong).
Stack full on-premise tanpa egress internet (Kong/Tyk self-hosted).
Perlu akses internal NGINX level.
Sudah heavily invested di Apigee/MuleSoft, cost migrasi terlalu besar.

Menguji Gateway Zuplo dengan Apidog

Setelah gateway aktif (di preview), uji semua rute & policy sebelum ke production. Gunakan Apidog:

Import OpenAPI spec (sama dengan rute Zuplo).
Panggil semua endpoint dengan API key valid/invalid untuk cek auth.
Kirim payload error untuk cek validasi request.
Uji rate limit dengan load.
Simpan environment variable (preview/prod URL, API key) untuk switching environment cepat.
Generate code sample (cURL, JS, Python, Go) untuk dokumentasi.

Jalankan juga automated test suite Apidog untuk coverage penuh. Coba ekstensi Apidog VS Code untuk testing langsung di editor, atau ikuti panduan migrasi dari Postman. Unduh Apidog untuk mulai.

Pertanyaan Umum tentang Gateway API Zuplo

Apakah Zuplo open source?

Core runtime closed source, tapi portal developer & beberapa library pendukung open source di GitHub. Opsi self-hosted tersedia untuk portal & gateway (Kubernetes). Umumnya tim pakai managed service.

Dapatkah Zuplo berjalan di infrastruktur saya sendiri?

Bisa, paket Enterprise sediakan opsi self-hosted Kubernetes. Tapi Anda kehilangan deployment edge global; semua operasi cluster ditangani sendiri.

Bagaimana Zuplo dibandingkan dengan Cloudflare API Shield?

API Shield fokus ke security (schema validation, abuse detection, mTLS), sedangkan Zuplo platform manajemen API lengkap (routing, policy, portal, monetisasi, MCP). Bisa dipakai bersamaan sesuai kebutuhan.

Apakah Zuplo bekerja dengan spesifikasi OpenAPI saya yang sudah ada?

Ya. OpenAPI jadi source of truth. Impor spec, rute otomatis, portal developer & validasi berbasis schema sama.

Dapatkah saya mengekspos gateway Zuplo ke agen AI seperti Claude atau Codex?

Bisa, lewat MCP Server Handler. Pilih operasi yang diekspos, gateway langsung siap dipanggil klien MCP. Auth & rate limit policy tetap berjalan.

Berapa lama waktu deployment Zuplo?

Push-to-deploy biasanya <60 detik untuk preview. Production lebih cepat karena artefak sudah dibuild. No maintenance window, deployment atomik.

Apa yang terjadi jika Cloudflare down?

Zuplo tergantung Cloudflare edge; outage regional Cloudflare akan mengganggu wilayah terkait. Paket Enterprise sediakan opsi multi-cloud failover untuk SLA 99,999%.

Kesimpulan

Zuplo adalah API gateway untuk tim yang ingin fitur enterprise tanpa beban operasional: policy TypeScript-native, GitOps deployment, portal developer otomatis, monetisasi built-in, serta support MCP untuk AI agent. Free tier cukup untuk traffic produksi nyata, dan Enterprise tier menutupi kebutuhan lanjut.

Untuk evaluasi, set up gateway nyata dalam 30 menit, uji dengan Apidog untuk validasi policy, dan putuskan dari hasil langsung. Kombinasi gateway edge managed & klien uji kuat adalah jalur tercepat dari “punya API” ke “punya produk.” Unduh Apidog dan mulai pengujian.

DEV Community