Blog

Zuplo API Ağ Geçidi Nedir?

Ashley Innocent

Ashley Innocent

27 April 2026

Zuplo API Ağ Geçidi Nedir?

enterprise.banner.title

enterprise.banner.feature1

enterprise.banner.feature2

enterprise.banner.feature3

enterprise.banner.ctaB

Çoğu API ağ geçidi hala 2014 operasyon ekibi için tasarlanmış gibi hissettiriyor. YAML yazıyorsunuz, bir kontrol düzlemiyle uğraşıyorsunuz ve değişikliklerinizi uygulamak için küme erişimi olan birini bekliyorsunuz. Zuplo bu modeli tersine çeviriyor. Rotalarınızın bir Git deposunda yaşadığı, politikalarınızın TypeScript olduğu ve her taahhütün saniyeler içinde 300'den fazla küresel konuma dağıtıldığı programlanabilir, uç-yerel bir API ağ geçididir. Bu kılavuz, Zuplo API ağ geçidinin ne yaptığını, Kong ve AWS API Ağ Geçidi'nden nasıl farklılaştığını, maliyetini ve ilk ağ geçidinizi otuz dakikadan daha kısa sürede nasıl dağıtabileceğinizi açıklıyor. Yönlendirme, kimlik doğrulama ve hız sınırlama için kod örneklerini ve üretime geçmeden önce Apidog ile her uç noktayı test etme bölümünü göreceksiniz.

Düğme

Zuplo, bir zamanlar Kong, Apigee ve AWS API Ağ Geçidi'nin egemen olduğu bir kategoride yer alıyor. Temel fikir basit: geliştiriciler gerçek bir programlama dili edinir, operasyonlar yönetilen bir hizmet alır ve ürün yerleşik bir para kazanma katmanı elde eder. Bu yazıda, bu değiş tokuşlar ve gerçek iş akışı açıklanmaktadır.

ÖZET

Zuplo Nedir?

Zuplo, üç fikir üzerine kurulu bir API yönetim platformudur: yapılandırma yerine kod, bölge yerine uç ve GUI yerine Git. Cloudflare'in uç ağında tamamen yönetilen bir hizmet olarak çalışır, böylece tek bir dağıtım, sizin hiçbir şey sağlamanıza gerek kalmadan 300'den fazla veri merkezine ulaşır.

Çoğu ağ geçidinin yapılandırmanızı bir kontrol düzlemi veritabanında depolanan bir YAML yapısı olarak ele aldığı yerlerde, Zuplo ağ geçidinizi bir TypeScript projesi olarak ele alır. Uç noktaları açıklayan bir `routes.oas.json` dosyanız, özel mantık için bir TypeScript modülleri klasörünüz ve bağladığınız politikalar için bir yapılandırma dosyanız bulunur. GitHub'a push yapın ve platform inşa eder, doğrular ve dağıtır.

Platform REST, GraphQL, gRPC, WebSockets ve SOAP'u destekler. SOC 2 Tip II uyumludur, AWS, Azure ve GCP arka uçlarında çalışır ve katı veri yerleşimi kuralları olan ekipler için kendi kendine barındırılan Kubernetes seçeneği sunar. Fiyatlandırma ücretsiz başlar ve koltuk başına ücretler yerine istek hacmine göre ölçeklenir. Tam döküm Zuplo fiyatlandırma sayfasında yer almaktadır.

Geliştiriciler Neden Kong, Apigee ve AWS API Ağ Geçidi Yerine Zuplo'yu Seçiyor?

Her ağ geçidinin bir kişiliği vardır. Kong, size maksimum kontrol sağlayan ve karşılığında Lua uzmanlığı isteyen açık kaynaklı ağır sıklettir. Apigee, derin analitiklere sahip ve öğrenme eğrisi dik olan kurumsal bir platformdur. AWS API Ağ Geçidi, yığınınız zaten AWS'de yaşıyorsa varsayılandır, ancak geliştirici portalı eksiktir ve Lambda entegrasyonlarındaki soğuk başlatma maliyeti gerçektir.

Zuplo farklı bir alıcıyı hedefler: bunları çalıştırmak için platform mühendisliği personeli olmadan kurumsal düzeyde özellikler isteyen küçük ekip.

Birkaç özel fark:

Ekibiniz zaten Kong veya Apigee'ye yatırım yapmışsa ve operasyonel yük sorun değilse, geçiş yapmak nadiren buna değerdir. Yeni bir seçim yapıyorsanız veya mevcut ağ geçidiniz size karşı koyuyorsa, Zuplo iş akışı bugün piyasaya sürülen herhangi bir platformun en net iyileştirmesidir.

Zuplo API Ağ Geçidinin Temel Özellikleri

TypeScript Öncelikli Programlanabilirlik

Ağ geçidi davranışı, rotalarınızın yanında bulunan TypeScript dosyalarında tanımlanır. Özel gelen ve giden politikalar, isteği alan, istediğiniz her şeyi yapan ve değiştirilmiş isteği veya yanıtı döndüren fonksiyonlardır. Tam TypeScript araç zincirini elde edersiniz: tipler, otomatik tamamlama, yeniden düzenleme ve testler.

Müşterilere yanıt vermeden önce dahili bir başlığı kaldıran önemsiz bir giden politika:

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;
}

Politikanın tamamı bu. `modules/strip-internal-header.ts` içine bırakın, rotanızda referans verin, Git'e itin ve dağıtılır.

60+ Önceden Oluşturulmuş Politika

Çoğu ekip temel şeyler için özel kod yazmayacaktır. Zuplo, API anahtarı kimlik doğrulaması, JWT doğrulama, OAuth 2.0, hız sınırlama (sabit pencere, kayan pencere, jeton kovası), OpenAPI şemanıza göre istek ve yanıt doğrulama, CORS, IP izin listeleri, istek dönüşümü ve bir avuç yukarı akış entegrasyonunu kapsayan 60'tan fazla önceden oluşturulmuş politika sunar. Bunları rota tanımını düzenleyerek bağlarsınız; standart durumlar için kod değişikliği gerekmez.

Otomatik Oluşturulan Geliştirici Portalı

Portalı OpenAPI spesifikasyonunuza yönlendirin ve etkileşimli deneme konsolları, cURL, JavaScript, Python, Go ve diğerlerinde kod örnekleri, ayrıca self servis API anahtarı verme özellikleriyle barındırılan bir dokümantasyon sitesi elde edersiniz. Son kullanıcılar kayıt olabilir, anahtarlar oluşturabilir ve API'yi tek bir insan müdahalesi olmadan çağırmaya başlayabilir. Geliştirici benimsemesine dayanan SaaS API'leri için, sadece bu bile platformu haklı çıkarır.

Yerleşik API Para Kazanma

Zuplo, API erişimi satmak için bir Stripe entegrasyonu sunar. Planları (ücretsiz, pro, kurumsal) tanımlarsınız, Stripe'ı bağlarsınız ve portal ödeme, abonelik yönetimi ve kullanım faturalandırmasını halleder. Bu, API ağ geçitlerinde nadirdir; Kong ve AWS API Ağ Geçidi, para kazanmayı okuyucuya bir egzersiz olarak bırakır. API çağrıları için ücret alıyorsanız, Zuplo para kazanma akışı haftalar sürecek bir inşa sürecini ortadan kaldırır.

Yapay Zeka Aracıları için MCP Sunucu İşleyicisi

En yeni eklenen özellik MCP Sunucu İşleyicisidir. Onu OpenAPI spesifikasyonunuza yönlendirin, hangi işlemleri açığa çıkaracağınızı seçin ve mevcut API'niz Claude Code, OpenAI Codex, Cursor ve diğer tüm MCP uyumlu istemciler tarafından çağrılabilir hale gelir. İnsan çağırıcılar için uyguladığınız aynı kimlik doğrulama ve hız sınırlama politikaları yapay zeka aracılar için de geçerli olur. Zuplo, yapılandırmayı ayrıntılı olarak ele alan API'leri MCP aracılığıyla açığa çıkarma hakkında bir kılavuz yayınladı.

Uç Dağıtım, 50ms Altı Gecikme

Her ağ geçidi varsayılan olarak 300'den fazla Cloudflare uç konumuna dağıtılır. Platform, soğuk başlatma olmaksızın uçta 50ms altı gecikme süresi iddia ediyor. Pratikte bu, Singapur'daki bir kullanıcının API'nize eriştiğinde Singapur'da bulunan bir ağ geçidine ulaştığı ve bunun da sizin kaynağınızın bulunduğu yere proxy yaptığı anlamına gelir. Bunu yapılandırmazsınız; bu tek dağıtım modudur.

Zuplo Perde Arkasında Nasıl Çalışır?

En yakın uç konuma bir istek ulaşır ve bu işlem hattından geçer:

  1. Rota eşleşmesi. İstek URL'si ve metodu, doğru işleyiciyi bulmak için `routes.oas.json` dosyanızla eşleştirilir.
  2. Gelen politikalar. Bağladığınız her şey (API anahtarı kimlik doğrulaması, JWT doğrulama, hız sınırlama, şema doğrulama) sırayla çalışır. Bir politika bir hata atarsa veya bir yanıt döndürürse, işlem hattı kısa devre yapar ve bu yanıt istemciye geri gönderilir.
  3. İşleyici. İşleyici yukarı akış kaynağınıza proxy yapar, statik bir değer döndürür, özel TypeScript kodu çalıştırır veya MCP Sunucu İşleyicisini çağırır.
  4. Giden politikalar. Yanıt dönüşümleri, başlık kaldırma ve tüm özel giden mantık çalışır.
  5. Yanıt. Son yanıt istemciye geri gönderilir; günlükler ve metrikler Zuplo'nun gözlemlenebilirlik katmanına (veya entegrasyonlar aracılığıyla kendi sağlayıcınıza) gönderilir.

Tüm bunlar bir Cloudflare Worker'da çalışır, bu yüzden gecikme süreleri geçerlidir ve boş kapasite için ödeme yapmazsınız.

İlk Zuplo Ağ Geçidinizi Kurma

Yaklaşık otuz dakikada çalışan bir ağ geçidi oluşturabilirsiniz. İş akışının şekli şöyledir:

  1. zuplo.com adresinden kaydolun ve yeni bir proje oluşturun. Projenin kontrol ettiğiniz bir depoya senkronize olması için GitHub entegrasyonunu seçin.
  2. Bir OpenAPI spesifikasyonunu içe aktarın. Yukarı akış API'nizin zaten bir tane varsa, onu içe aktarın. Zuplo her işlemi bir rotaya dönüştürür. Henüz bir spesifikasyonunuz yoksa, rotaları UI'de çizebilir ve spesifikasyonu daha sonra dışa aktarabilirsiniz.
  3. Bir API anahtarı kimlik doğrulama politikası ekleyin. Rota düzenleyicisinde `api-key-inbound` politikasını ekleyin. Zuplo tüketici veritabanını ve anahtar verme UI'sini sizin için oluşturur.
  4. Bir hız sınırı ekleyin. `rate-limit-inbound` politikasını, API anahtarı başına dakikada 100 istek gibi bir istek bütçesiyle bırakın. Bu, rota dosyasındaki tek bir JSON bloğudur.
  5. Dağıtın. Dalınıza push yapın. Zuplo benzersiz bir URL ile bir önizleme ortamı oluşturur. Bir birleştirmeyle üretime yükseltin.
  6. Ağ geçidini uçtan uca test edin. Yeni ağ geçidi URL'sine geçerli ve geçersiz API anahtarları, aşılmış hız sınırları ve hatalı yüklerle istek göndermek için Apidog kullanın. Görsel yanıt denetleyicisi, doğru politikanın doğru sırayla çalıştığını doğrulamayı kolaylaştırır.

İlk proje dakikalar içinde dağıtılır. Daha zor olan iş, rotaları iyi adlandırmak ve özel mantığı nereye koyacağınıza karar vermektir, bu da herhangi bir platformda karşılaşacağınız aynı problemdir.

TypeScript'te Özel Politikalar Yazma

Önceden oluşturulmuş politikalar, yaygın durumları kapsar. Diğer her şey için özel bir politika yazın. Tipik bir örnek, isteği kaynağınıza ulaşmadan önce dahili bir hizmetten gelen verilerle zenginleştirmektir:

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;
}

Burada dikkate değer üç şey var. Birincisi, politika normal bir asenkron fonksiyondur; onu test etmek birim testidir, donanım ağırlıklı bir entegrasyon testi değildir. İkincisi, ortam değişkenleri `context.environment`'dan gelir, bu tür açısından güvenlidir ve proje ayarlarınızdan çekilir. Üçüncüsü, bir `Response` döndürmek işlem hattını kısa devre yapar, bu da kimlik doğrulama hatalarını veya yukarı akış hatalarını düzgün bir şekilde ifade etmenizi sağlar.

2026'da Zuplo Fiyatlandırması

Zuplo'nun fiyatlandırması bu kategori için alışılmadık derecede basittir. Üç plan:

AI Ağ Geçidi ve Geliştirici Portalı ürünleri, ayda 0$ olan açık kaynaklı kendi kendine barındırılan portal dahil olmak üzere ayrı katmanlara sahiptir. Güncel rakamlar Zuplo fiyatlandırma sayfasında yer almaktadır ve bir sözleşme imzalamadan önce kontrol etmeye değerdir.

Karşılaştırma için: AWS API Gateway, milyon REST isteği başına 3,50 dolar, ardından veri transferi ve Lambda entegrasyonlarını kullanırsanız Lambda maliyetleri alır. Kong'un kurumsal katmanı özeldir ve tarihsel olarak Zuplo'nun 1.000 dolarlık tabanının oldukça üzerindedir. Yalnızca ücretsiz katman, Zuplo'yu erken aşama projeler için yenilmez hale getirir.

Zuplo Ne Zaman Doğru Tercih, Ne Zaman Değil?

Zuplo, şu durumlarda güçlü bir seçimdir:

Zuplo, şu durumlarda yanlış bir seçimdir:

Zuplo Ağ Geçidinizi Apidog ile Test Etme

Ağ geçidiniz bir önizleme ortamında yayına girdikten sonra, üretime geçmeden önce her rotayı, her politikayı ve her uç durumu test etmeniz gerekir. İşte bu noktada özel bir API istemcisi değerini kanıtlar.

Apidog, OpenAPI spesifikasyonunuzu doğrudan içe aktarır, böylece Zuplo rotalarınızı besleyen aynı spesifikasyon test paketinizi de besler. Buradan şunları yapabilirsiniz:

Ayrıca, Apidog'un otomatik test senaryolarını ağ geçidine karşı çalıştırabilirsiniz, bu tek seferlik komut dosyaları yazmaktan daha hızlıdır. Daha önce Apidog kullanmadıysanız, Apidog VS Code uzantısı, editörünüzden çıkmadan istek göndermenizi sağlar ve başka bir istemciden geliyorsanız Postman olmadan API testi kılavuzu, geçiş sürecini anlatır. Başlamak için Apidog'u indirin.

Zuplo API Ağ Geçidi Hakkında Sıkça Sorulan Sorular

Zuplo Açık Kaynak mı?

Temel ağ geçidi çalışma zamanı kapalı kaynaklıdır, ancak Zuplo, geliştirici portalını ve bazı destekleyici kütüphaneleri GitHub'da açık kaynak haline getirmiştir. Kendi kendine barındırılan bir seçeneğe ihtiyacınız varsa, açık kaynaklı portal ve ağ geçidinin kendi kendine barındırılan Kubernetes dağıtımı çoğu ihtiyacı karşılar. Çoğu ekip yönetilen hizmeti kullanmaya devam eder.

Zuplo Kendi Altyapımda Çalışabilir mi?

Evet. Enterprise planı, kendi kendine barındırılan Kubernetes seçeneğini içerir. Bunun karşılığı, küresel uç dağıtımdan vazgeçmeniz ve küme operasyonlarını kendiniz üstlenmenizdir. Katı veri yerleşimi kuralları olan ekipler için bu doğru bir karardır.

Zuplo, Cloudflare API Shield ile Nasıl Karşılaştırılır?

API Shield, herhangi bir kaynağın önünde yer alan güvenlik odaklı bir üründür (şema doğrulama, kötüye kullanım tespiti, mTLS). Zuplo ise tam bir API yönetim platformudur: yönlendirme, politikalar, geliştirici portalı, para kazanma, MCP desteği. Bu ikisi bir arada var olabilir. Yalnızca güvenlik sinyallerine ihtiyacınız varsa, API Shield yeterlidir. Tam yaşam döngüsüne ihtiyacınız varsa, Zuplo platformdur.

Zuplo Mevcut OpenAPI Spesifikasyonumla Çalışıyor mu?

Evet. Zuplo'da OpenAPI, doğruluk kaynağıdır. Spesifikasyonu içe aktarın, rotalar görünür, geliştirici portalı aynı spesifikasyondan oluşturulur ve istek doğrulama politikaları aynı şemaları kullanır. Spesifikasyonunuz dağınıksa, içe aktarma süreci bunu öğrenme anınız olacaktır.

Zuplo Ağ Geçidimi Claude veya Codex Gibi Yapay Zeka Ajanlarına Açabilir miyim?

Evet, MCP Sunucu İşleyicisi aracılığıyla. İşleyiciyi OpenAPI spesifikasyonunuza yönlendirir, hangi işlemleri açığa çıkaracağınızı seçersiniz ve ağ geçidi herhangi bir MCP uyumlu istemci tarafından çağrılabilir hale gelir. İnsan çağırıcılar için tanımladığınız aynı kimlik doğrulama ve hız sınırı politikaları otomatik olarak uygulanır.

Bir Zuplo Dağıtımı Ne Kadar Sürer?

Bir push-to-deploy döngüsü, bir önizleme ortamı için genellikle altmış saniyenin altında sürer. Üretim yükseltmeleri daha hızlıdır çünkü yapıt zaten oluşturulmuştur. Bakım pencereleri yoktur; dağıtımlar atomiktir.

Cloudflare Çökerse Ne Olur?

Zuplo, Cloudflare'in uç ağında çalışır, bu nedenle bir Cloudflare bölgesel kesintisi o bölgeyi etkileyecektir. Enterprise planı, %99,999 kullanılabilirlik gerektiren ekipler için çoklu bulut hata toleransı seçenekleri sunar. Çoğu ekip, Cloudflare'in güvenilirlik geçmişi göz önüne alındığında bağımlılığı kabul eder.

Sonuç

Zuplo, operasyonel yük olmadan kurumsal özellikler isteyen ekipler için API ağ geçididir. TypeScript-yerel politikalar, GitOps dağıtımları, otomatik oluşturulan geliştirici portalı, yerleşik para kazanma ve şimdi yapay zeka ajanları için MCP desteği, onu ince bir yönlendirme katmanı yerine eksiksiz bir platform haline getiriyor. Ücretsiz katman, gerçek üretim trafiği için yeterince cömerttir ve Enterprise planı geri kalanını halleder.

Değerlendiriyorsanız, gerçek API'lerinizden biriyle otuz dakikalık kurulumu yapın, her politikayı doğrulamak için Apidog aracılığıyla çalıştırın ve pazarlama sayfaları yerine kanıtlara göre karar verin. Yönetilen bir uç ağ geçidi ve güçlü bir test istemcisinin birleşimi, "bir API'miz var"dan "bir ürünümüz var"a giden en hızlı yoldur. Apidog'u indirin ve test etmeye başlayın.

Düğme

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir