Tobias Hoffmann

Posted on Apr 27 • Originally published at apidog.com

Zuplo API Ağ Geçidi Nedir?

Çoğu API ağ geçidi hâlâ 2014 operasyon ekibi için tasarlanmış gibi hissettiriyor. YAML dosyalarını yönetiyorsunuz, kontrol düzlemiyle uğraşıyorsunuz ve değişikliklerinizi uygulamak için küme erişimi olan birinden yardım bekliyorsunuz. Zuplo bu modeli tersine çeviriyor: Rotalarınızın bir Git deposunda yaşadığı, politikalarınızı TypeScript ile yazabildiğiniz ve her taahhüdün saniyeler içinde 300'den fazla küresel konuma dağıtıldığı, programlanabilir ve uç-yerel bir API ağ geçidi. Bu yazıda Zuplo API ağ geçidinin yeteneklerini, Kong ve AWS API Gateway'den nasıl ayrıştığını, fiyatlandırmasını ve otuz dakikadan kısa sürede ilk ağ geçidinizi nasıl kuracağınızı adım adım bulacaksınız. Ayrıca yönlendirme, kimlik doğrulama ve hız sınırlama için örnek kodları ve üretime geçmeden önce Apidog ile uç noktalarınızı nasıl test edebileceğinizi anlatan pratik başlıklar da mevcut.

Apidog'u bugün deneyin

Zuplo, bir zamanlar Kong, Apigee ve AWS API Gateway'in hâkim olduğu bir kategoride rekabet ediyor. Temel yaklaşım: Geliştiriciler gerçek bir programlama dili ve modern bir iş akışıyla çalışır, operasyonlar yönetilen bir hizmet alır, ürün ise yerleşik para kazanma araçlarına sahip olur. Bu yazı, bu farkları ve pratik iş akışını özetliyor.

ÖZET

Zuplo, 300'den fazla Cloudflare veri merkezinde 50ms'den kısa gecikme ve sıfır soğuk başlatma ile rotalarınızı çalıştıran, tamamen yönetilen uç-yerel bir API ağ geçididir.
Yapılandırma GitOps tabanlıdır; ağ geçidiniz bir Git deposunda yaşar, dağıtımlar CI/CD üzerinden yapılır.
Politikalar, YAML/Lua yerine TypeScript ile yazılır, tam IDE desteği vardır.
Ücretsiz katman, sınırsız ortam, API anahtarı ve geliştirici portalı ile ayda 100.000 isteği kapsar.
API anahtarı kimlik doğrulama, JWT, OAuth2, hız sınırlama, istek doğrulama, otomatik geliştirici portalı ve Stripe ile para kazanma dahili olarak gelir.
Zuplo artık MCP Sunucu İşleyicisi sunuyor; böylece herhangi bir rota Claude, Codex, Cursor gibi MCP istemcilerine açılabilir.
Her Zuplo rotasını üretime almadan önce uçtan uca Apidog ile test edin.

Zuplo Nedir?

Zuplo, üç temel ilkeye dayalı bir API yönetim platformudur: yapılandırma yerine kod, bölge yerine uç, GUI yerine Git. Cloudflare’in uç ağında tamamen yönetilen bir hizmet olarak çalışır; bir dağıtım yaptığınızda 300+ veri merkezine otomatik olarak ulaşır.

Çoğu ağ geçidi yapılandırmanızı bir YAML dosyasında ya da kontrol düzlemi veritabanında saklarken, Zuplo ağ geçidinizi bir TypeScript projesi olarak ele alır. Temel dosya yapısı:

routes.oas.json: Uç noktaları tanımlar
modules/: Özel TypeScript modülleri (politikalar)
zuplo.json: Politika ve yapılandırma dosyası

GitHub’a push yaptığınızda platform otomatik olarak oluşturur, doğrular ve dağıtır.

Platform REST, GraphQL, gRPC, WebSockets ve SOAP’u destekler. SOC 2 Tip II uyumlu, AWS, Azure ve GCP üzerinde çalışabiliyor; kendi kendine barındırılan Kubernetes seçeneği de var. Fiyatlandırma istek hacmine göre; detaylar için Zuplo fiyatlandırma sayfasına bakabilirsiniz.

Geliştiriciler Neden Kong, Apigee ve AWS API Gateway Yerine Zuplo'yu Seçiyor?

Her ağ geçidinin kendine özgü bir karakteri var. Kong maksimum kontrol isteyen, karşılığında Lua uzmanlığı gerektiren açık kaynaklı bir ağır sıklet. Apigee kurumsal segmentte, derin analizler ve yüksek öğrenme eğrisine sahip. AWS API Gateway ise AWS kullananlar için varsayılan, ancak geliştirici portalı zayıf ve Lambda entegrasyonu soğuk başlatma problemi taşıyor.

Zuplo, platform mühendisliği ekibi olmayan küçük ama kurumsal ihtiyaçlardaki ekipler için ideal. Fark yaratan noktalar:

YAML değil, kod: Bir hız sınırlama politikası Zuplo’da üç satır TypeScript ile yazılır. Kong’da aynı iş için 15+ satır YAML gerekir.
Geliştirici portalı dahili: Kong’da portal sadece kurumsal plana dahildir. Zuplo’da ücretsiz katman da dâhil, OpenAPI spesifikasyonundan otomatik portal oluşturulur.
Varsayılan GitOps: Tüm değişiklikler çekme isteğidir. Otomatik inceleme, denetim ve revert desteği var.
Uç-yerel, soğuk başlatma yok: Cloudflare Workers üzerinde çalışır. İstekler milisaniyeler içinde en yakın veri merkezinden ulaşır.

Eğer ekibinizde Kong/Apigee yatırımı varsa ve operasyonel yük sorun değilse geçiş şart değil. Ancak yeni başlıyorsanız, Zuplo iş akışında belirgin avantaj sunar.

Zuplo API Ağ Geçidinin Temel Özellikleri

TypeScript Öncelikli Programlanabilirlik

Ağ geçidi davranışı, rotalarınızın yanında TypeScript dosyalarında tanımlanır. İsteğe özel gelen/giden politikalar, fonksiyon olarak yazılır. Tam tip desteği, otomatik tamamlama ve test kolaylığı sağlar.

Örnek: Yanıttan dahili bir başlığı kaldıran 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;
}

Bu dosyayı modules/strip-internal-header.ts olarak ekleyin, rotada referans verin, Git’e itin—hepsi bu.

60+ Hazır Politika

API anahtarı kimlik doğrulama, JWT doğrulama, OAuth 2.0, hız sınırlama, istek/yanıt doğrulama, CORS, IP listeleme, istek dönüşümü ve upstream entegrasyonları için 60’tan fazla hazır politika. Sadece rota tanımında ekleyin, kod yazmak gerekmez.

Otomatik Oluşan Geliştirici Portalı

OpenAPI spesifikasyonunuza bağlayın; etkileşimli deneme, cURL/JS/Python/Go örnekleri, self-servis API anahtar yönetimiyle portal anında hazır.

Yerleşik API Para Kazanma

Stripe ile entegre olarak API erişimi satabilirsiniz. Plan tanımlayın, Stripe bağlayın, ödemeler ve abonelik yönetimi otomatik çalışır.

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

OpenAPI spesifikasyonunuzu yönlendirin, hangi işlemleri açacağınızı seçin. Böylece Claude Code, OpenAI Codex, Cursor ve diğer MCP istemcileri API’nizi otomatik kullanabilir. Standart politikalara ek olarak AI agent’lar için de kimlik doğrulama ve hız sınırlama çalışır. Detaylı rehber: API’leri MCP ile açma.

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

Her dağıtım Cloudflare’in 300+ bölgesine otomatik gider. Hiçbir ek yapılandırma gerekmez; her istek kullanıcıya en yakın uç noktadan yönlendirilir.

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

Bir istek uç konumda şu sırayla işlenir:

Rota Eşleşmesi: URL ve metot, routes.oas.json ile eşleşir.
Gelen Politikalar: API anahtarı, JWT, hız sınırlama, şema doğrulama gibi politikalar sırayla uygulanır.
İşleyici: Proxy, statik yanıt, özel TypeScript kodu veya MCP’ye çağrı yapılır.
Giden Politikalar: Yanıt dönüşümleri ve başlık manipülasyonu.
Yanıt: Müşteriye döner; loglar ve metrikler gözlemlenebilirlik katmanına gider.

Tüm pipeline Cloudflare Worker’da çalışır. Gecikme düşük, kapasite kullanımı optimize.

İlk Zuplo Ağ Geçidinizi Kurma

30 dakikadan kısa sürede ilk çalışan ağ geçidinizi kurmak için adımlar:

Kayıt ve Proje Oluşturma: zuplo.com’dan kaydolun, yeni proje başlatın. GitHub entegrasyonu ile kendi deponuza bağlayın.
OpenAPI Spesifikasyonunu İçe Aktarın: Mevcut bir OpenAPI spesiniz varsa, içe aktarın. Yoksa UI üzerinden rotaları oluşturun.
API Anahtarı Kimlik Doğrulama Politikası Ekleyin: Rota düzenleyicide api-key-inbound politikasını ekleyin. Zuplo otomatik olarak tüketici veritabanı ve anahtar UI’si oluşturur.
Hız Sınırı Ekleyin: rate-limit-inbound politikasını, örneğin anahtar başına dakikada 100 istek ile ekleyin. Sadece rota dosyasına JSON bloğu eklemeniz yeterli.
Dağıtın: Dalınıza push yapın. Zuplo önizleme ortamı oluşturur, merge sonrası prod’a çıkar.
Ağ Geçidini Test Edin: Yeni gateway URL’sine geçerli/geçersiz API anahtarı, aşılmış limit ve hatalı yüklerle istek göndermek için Apidog kullanın.

Kurulum dakikalar içinde tamamlanır. Asıl zorluk rotaları iyi adlandırmak ve mantık ayrımını doğru yapmaktır.

TypeScript'te Özel Politikalar Yazma

Hazır politikalar çoğu durumu kapsar. Özel gereksinimler için TypeScript ile yeni politika yazabilirsiniz. Örnek: İstekleri, upstream’e ulaşmadan önce dahili bir hizmetten gelen verilerle zenginleştirin.

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:

Politika normal bir async fonksiyon, kolayca birim test edilebilir.
Ortam değişkenlerine context.environment ile erişilir, tip güvenli.
Response döndürmek işlem hattını kısa devre yapar (ör: kimlik doğrulama hatası).

2026'da Zuplo Fiyatlandırması

Üç ana plan:

Ücretsiz, ayda 0$: Ayda 100K istek, sınırsız ortam, sınırsız API anahtarı ve geliştirici portalı, 1 GB çıkış, 2 geliştirici.
Builder, ayda 25$: 1M istek, 2 özel alan adı, 100K istek başına 1 GB çıkış, ek istek başı 100$.
Enterprise, 1.000$+ / ay: Sınırsız istek ve alan adı, %99,5–%99,999 SLA, GitHub Enterprise/GitLab/Azure DevOps entegrasyonu, SSO, RBAC ve 7/24 destek.

AI Ağ Geçidi ve Geliştirici Portalı ürünleri ayrı katmanlarda; güncel rakamlar için Zuplo fiyatlandırma sayfasına bakın.

AWS API Gateway milyon REST isteği başına 3.50$, veri transferi ve Lambda maliyetleri eklenir. Kong’un kurumsal katmanı genelde Zuplo Enterprise’dan daha pahalı. Sadece ücretsiz katman bile erken aşama projeler için fazlasıyla yeterli.

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

Zuplo’yu seçin:

Yönetilen ağ geçidi istiyor, Kubernetes üstünde Kong kurmak istemiyorsanız
Ekibiniz TypeScript/JavaScript’e hâkimse
Ayrı bir satıcı kullanmadan geliştirici portalı istiyorsanız
API’den gelir elde edip Stripe faturalandırmasını entegre etmek istiyorsanız
API’nizi AI agent’lara açmak ve MCP desteği almak istiyorsanız
Trafiğiniz küresel ve uç gecikmesi kritikse

Zuplo uygun değil:

Tam açık kaynak kod kontrolü gerekiyorsa (Kong)
Tamamen şirket içi, internete çıkışı olmayan bir mimariniz varsa (Kong/Tyk self-hosted)
NGINX’in dahili özelliklerine erişmeniz gerekiyorsa
Zaten Apigee veya MuleSoft’a derin yatırımınız varsa

Zuplo Ağ Geçidinizi Apidog ile Test Etme

Gateway’iniz önizleme ortamında yayına alındıktan sonra, üretime geçmeden önce tüm rotaları ve politikaları kapsamlıca test edin. Bu noktada bir API istemcisi şart.

Apidog, OpenAPI spesifikasyonunuzu direkt içe aktarır ve Zuplo rotalarınızı test paketiyle eşleştirir. Şunları kolayca yapabilirsiniz:

Her rotayı geçerli/geçersiz API anahtarı ile çağırıp kimlik doğrulama politikalarını doğrulayın
Hatalı yüklerle istek doğrulamasını test edin
Hız sınırlama eşiklerinde rate limit politikalarını zorlayın
Ortam değişkenleri ile önizleme/üretim URL ve anahtarlarını yönetin
cURL, JS, Python ve Go kod örnekleri oluşturun

Ayrıca Apidog’un otomatik test senaryoları ile, manuel script yazmaya gerek kalmadan hızlıca kapsamlı testler yapabilirsiniz. VS Code uzantısı için buraya, Postman alternatifi için buraya bakabilirsiniz. Başlamak için Apidog'u indirin.

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

Zuplo Açık Kaynak mı?

Çekirdek çalışma zamanı kapalı kaynaklı, ancak geliştirici portalı ve bazı yardımcı kütüphaneler açık kaynak. Kendi kendine barındırılan Kubernetes seçeneği mevcut; çoğu ekip yönetilen hizmeti tercih ediyor.

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

Evet. Enterprise planında self-hosted Kubernetes seçeneği var; karşılığında küresel uç dağıtımdan vazgeçersiniz ve operasyon sizde olur.

Zuplo, Cloudflare API Shield ile Karşılaştırıldığında?

API Shield temel güvenlik (schema validation, abuse detection, mTLS) sunar. Zuplo ise tam yönetim platformu: yönlendirme, politika, portal, para kazanma, MCP. İhtiyaçlarınıza göre ikisini birlikte de kullanabilirsiniz.

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

Evet. Spesifikasyonu içe aktarın, rotalar ve portal otomatik oluşur; istek doğrulama aynı şemayı kullanır.

Zuplo Ağ Geçidimi Claude veya Codex Gibi AI Agent’lara Açabilir miyim?

Evet, MCP Sunucu İşleyicisi ile. OpenAPI spesini yönlendirip hangi işlemleri açacağınızı seçersiniz, AI agent’lar aynı kimlik doğrulama ve hız sınırlama kurallarıyla erişir.

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

Push-to-deploy döngüsü önizleme ortamı için genellikle 60 saniyeden kısa sürer. Üretim yükseltmeleri daha da hızlıdır; bakım penceresi yoktur.

Cloudflare Çökerse Ne Olur?

Zuplo, Cloudflare uç ağında çalışır. Bölgesel bir kesinti o bölgeyi etkiler. Enterprise planı için çoklu bulut seçenekleri var. Standart ekipler Cloudflare’in genel güvenilirliğine güvenir.

Sonuç

Zuplo, operasyonel karmaşa olmadan kurumsal API özellikleri isteyen ekipler için güçlü bir seçenektir. TypeScript tabanlı politikalar, GitOps dağıtım, otomatik geliştirici portalı, entegre para kazanma ve AI agent’lar için MCP desteği ile yalnızca bir yönlendirme katmanı değil, tam bir platform sunar. Ücretsiz katman gerçek üretim için yeterlidir; daha büyük ihtiyaçlar için Enterprise mevcut.

Denemek için, gerçek API’nizle 30 dakikalık kurulumu tamamlayın, tüm politikaları Apidog ile test edin ve kararınızı gerçek kullanım üzerinden verin. Yönetilen uç gateway ve güçlü bir test istemcisi, "API’miz var"dan "ürünümüz var"a geçişin en hızlı yoludur. Apidog'u indirin ve test sürecine başlayın.

DEV Community