Blog

Zuplo API Gateway: Was ist das?

Ashley Innocent

Ashley Innocent

27 April 2026

Zuplo API Gateway: Was ist das?

Die meisten API-Gateways fühlen sich immer noch so an, als wären sie für ein Ops-Team aus dem Jahr 2014 konzipiert worden. Man schreibt YAML, kämpft mit einer Steuerungsebene und wartet darauf, dass jemand mit Clusterzugriff die Änderungen pusht. Zuplo dreht dieses Modell um. Es ist ein programmierbares, Edge-natives API-Gateway, bei dem Ihre Routen in einem Git-Repository leben, Ihre Richtlinien in TypeScript geschrieben sind und jeder Commit in Sekundenschnelle an über 300 globalen Standorten bereitgestellt wird.

Dieser Leitfaden erklärt, was das Zuplo API-Gateway leistet, wie es sich von Kong und AWS API Gateway unterscheidet, was es kostet und wie Sie Ihr erstes Gateway in weniger als dreißig Minuten in Betrieb nehmen können. Sie sehen Codebeispiele für Routing, Authentifizierung und Ratenbegrenzung sowie einen Abschnitt zum Testen jedes Endpunkts mit Apidog, bevor er in Produktion geht.

button

Zuplo gehört zu einer Kategorie, die früher von Kong, Apigee und AWS API Gateway dominiert wurde. Das Prinzip ist einfach: Entwickler erhalten eine echte Programmiersprache, der Betrieb erhält einen verwalteten Dienst und das Produkt erhält eine integrierte Monetarisierungsebene. Die Kompromisse und der tatsächliche Workflow werden in diesem Beitrag erläutert.

TL;DR

Was ist Zuplo?

Zuplo ist eine API-Management-Plattform, die auf drei Ideen aufbaut: Code statt Konfiguration, Edge statt Region und Git statt GUI. Es läuft als vollständig verwalteter Dienst im Edge-Netzwerk von Cloudflare, sodass eine einzige Bereitstellung ohne Ihr Zutun in über 300 Rechenzentren landet.

Während die meisten Gateways Ihre Konfiguration als YAML-Artefakt in einer Control-Plane-Datenbank behandeln, behandelt Zuplo Ihr Gateway als TypeScript-Projekt. Sie erhalten eine routes.oas.json-Datei, die Endpunkte beschreibt, einen Ordner mit TypeScript-Modulen für benutzerdefinierte Logik und eine Konfigurationsdatei für die Richtlinien, die Sie integrieren. Pushen Sie zu GitHub, und die Plattform erstellt, validiert und stellt bereit.

Die Plattform unterstützt REST, GraphQL, gRPC, WebSockets und SOAP. Sie ist SOC 2 Typ II-konform, läuft über AWS-, Azure- und GCP-Backends und bietet eine selbst gehostete Kubernetes-Option für Teams mit strengen Datenresidenzregeln. Die Preisgestaltung beginnt kostenlos und skaliert mit dem Anfragevolumen statt mit Gebühren pro Platz. Die vollständige Aufschlüsselung finden Sie auf der Zuplo-Preisgestaltungsseite.

Warum Entwickler Zuplo gegenüber Kong, Apigee und AWS API Gateway bevorzugen

Jedes Gateway hat eine Persönlichkeit. Kong ist das Open-Source-Schwergewicht, das maximale Kontrolle bietet und dafür Lua-Expertise erfordert. Apigee ist die Unternehmensplattform mit tiefgehenden Analysen und einer steilen Lernkurve. AWS API Gateway ist die Standardlösung, wenn Ihr Stack bereits in AWS läuft, aber das Entwicklerportal fehlt und die Kaltstartkosten bei Lambda-Integrationen sind real.

Zuplo richtet sich an eine andere Zielgruppe: das kleine Team, das Enterprise-Funktionen wünscht, ohne das Personal für Plattform-Engineering zu haben, um sie zu betreiben.

Einige spezifische Unterschiede:

Wenn Ihr Team bereits in Kong oder Apigee investiert ist und der Betriebsaufwand in Ordnung ist, lohnt sich ein Wechsel selten. Wenn Sie neu beginnen oder Ihr aktuelles Gateway Ihnen Schwierigkeiten bereitet, ist der Zuplo-Workflow die deutlichste Verbesserung aller heute verfügbaren Plattformen.

Kernfunktionen des Zuplo API-Gateways

TypeScript-erste Programmierbarkeit

Das Gateway-Verhalten wird in TypeScript-Dateien definiert, die neben Ihren Routen liegen. Benutzerdefinierte eingehende und ausgehende Richtlinien sind Funktionen, die die Anfrage empfangen, tun, was Sie wollen, und die geänderte Anfrage oder Antwort zurückgeben. Sie erhalten die vollständige TypeScript-Toolchain: Typen, Autovervollständigung, Refactoring und Tests.

Eine triviale ausgehende Richtlinie, die einen internen Header entfernt, bevor sie auf Clients antwortet:

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

Das ist die gesamte Richtlinie. Legen Sie sie in modules/strip-internal-header.ts ab, referenzieren Sie sie in Ihrer Route, pushen Sie zu Git, und sie wird bereitgestellt.

Über 60 vorgefertigte Richtlinien

Die meisten Teams werden für die Grundlagen keinen benutzerdefinierten Code schreiben. Zuplo liefert über 60 vorgefertigte Richtlinien, die API-Schlüssel-Authentifizierung, JWT-Validierung, OAuth 2.0, Ratenbegrenzung (festes Fenster, gleitendes Fenster, Token-Bucket), Anfragen- und Antwortvalidierung gegen Ihr OpenAPI-Schema, CORS, IP-Zulassungslisten, Anfragetransformation und eine Handvoll Upstream-Integrationen abdecken. Sie integrieren sie durch Bearbeiten der Routendefinition; für Standardfälle sind keine Codeänderungen erforderlich.

Automatisch generiertes Entwicklerportal

Verweisen Sie das Portal auf Ihre OpenAPI-Spezifikation und Sie erhalten eine gehostete Dokumentationsseite mit interaktiven Try-it-Konsolen, Codebeispielen in cURL, JavaScript, Python, Go und anderen, sowie eine Self-Service-API-Schlüsselausstellung. Endbenutzer können sich anmelden, Schlüssel generieren und die API aufrufen, ohne dass ein Mensch eingreifen muss. Für SaaS-APIs, die von der Akzeptanz durch Entwickler abhängen, rechtfertigt dies allein oft die Plattform.

Integrierte API-Monetarisierung

Zuplo bietet eine Stripe-Integration zum Verkauf von API-Zugängen. Sie definieren Pläne (Free, Pro, Enterprise), verbinden Stripe, und das Portal übernimmt den Checkout, die Abonnementverwaltung und die Nutzungsabrechnung. Dies ist bei API-Gateways selten; Kong und AWS API Gateway überlassen die Monetarisierung dem Benutzer. Wenn Sie API-Aufrufe berechnen, eliminiert der Zuplo-Monetarisierungsflow einen mehrwöchigen Entwicklungsaufwand.

MCP-Server-Handler für KI-Agenten

Die neueste Ergänzung ist der MCP Server Handler. Verweisen Sie ihn auf Ihre OpenAPI-Spezifikation, wählen Sie aus, welche Operationen freigegeben werden sollen, und Ihre bestehende API wird von Claude Code, OpenAI Codex, Cursor und jedem anderen MCP-kompatiblen Client aufrufbar. Dieselben Authentifizierungs- und Ratenbegrenzungsrichtlinien, die Sie für menschliche Anrufer angewendet haben, gelten auch für KI-Agenten. Zuplo hat eine Anleitung zur Offenlegung von APIs über MCP veröffentlicht, die die Konfiguration detailliert behandelt.

Edge-Bereitstellung, Latenz unter 50 ms

Jedes Gateway wird standardmäßig an über 300 Cloudflare-Edge-Standorten bereitgestellt. Die Plattform beansprucht eine Latenz von unter 50 ms am Edge ohne Kaltstarts. In der Praxis bedeutet dies, dass ein Benutzer in Singapur, der Ihre API aufruft, ein in Singapur ansässiges Gateway trifft, das dann zu Ihrem Ursprung weiterleitet. Sie konfigurieren dies nicht; es ist der einzige Bereitstellungsmodus.

Wie Zuplo unter der Haube funktioniert

Eine Anfrage erreicht den nächstgelegenen Edge-Standort und durchläuft diese Pipeline:

  1. Routenabgleich. Die Anfrage-URL und -Methode werden mit Ihrer routes.oas.json abgeglichen, um den richtigen Handler zu finden.
  2. Eingehende Richtlinien. Alles, was Sie integriert haben (API-Schlüssel-Authentifizierung, JWT-Validierung, Ratenbegrenzung, Schemavalidierung), wird der Reihe nach ausgeführt. Wenn eine Richtlinie einen Fehler auslöst oder eine Antwort zurückgibt, wird die Pipeline kurzgeschlossen und diese Antwort geht an den Client zurück.
  3. Handler. Der Handler leitet an Ihren Upstream-Ursprung weiter, gibt einen statischen Wert zurück, führt benutzerdefinierten TypeScript-Code aus oder ruft den MCP-Server-Handler auf.
  4. Ausgehende Richtlinien. Antworttransformationen, Header-Entfernung und jede benutzerdefinierte ausgehende Logik werden ausgeführt.
  5. Antwort. Die endgültige Antwort geht an den Client zurück; Protokolle und Metriken werden an Zuplos Beobachtbarkeitsschicht (oder an Ihren eigenen Anbieter über Integrationen) gesendet.

Das Ganze läuft in einem Cloudflare Worker, weshalb die Latenzwerte eingehalten werden und Sie nicht für ungenutzte Kapazität bezahlen.

Einrichten Ihres ersten Zuplo Gateways

Sie können in etwa dreißig Minuten ein funktionierendes Gateway aufbauen. Hier ist der grobe Workflow:

  1. Melden Sie sich unter zuplo.com an und erstellen Sie ein neues Projekt. Wählen Sie die GitHub-Integration, damit das Projekt mit einem Repository synchronisiert wird, das Sie kontrollieren.
  2. Importieren Sie eine OpenAPI-Spezifikation. Wenn Ihre Upstream-API bereits eine hat, importieren Sie sie. Zuplo wandelt jede Operation in eine Route um. Wenn Sie noch keine Spezifikation haben, können Sie Routen in der Benutzeroberfläche skizzieren und die Spezifikation später exportieren.
  3. Fügen Sie eine API-Schlüssel-Authentifizierungsrichtlinie hinzu. Im Routen-Editor fügen Sie die Richtlinie api-key-inbound hinzu. Zuplo erstellt die Verbraucherdatenbank und die Benutzeroberfläche zur Schlüsselgenerierung für Sie.
  4. Fügen Sie eine Ratenbegrenzung hinzu. Fügen Sie die Richtlinie rate-limit-inbound mit einem Anfragenbudget von beispielsweise 100 Anfragen pro Minute pro API-Schlüssel hinzu. Dies ist ein JSON-Block in der Routendatei.
  5. Bereitstellen. Pushen Sie in Ihren Branch. Zuplo erstellt eine Vorschauumgebung mit einer eindeutigen URL. Überführen Sie in die Produktion mit einem Merge.
  6. Testen Sie das Gateway End-to-End. Verwenden Sie Apidog, um Anfragen an die neue Gateway-URL mit gültigen und ungültigen API-Schlüsseln, überschrittenen Ratenbegrenzungen und fehlerhaften Payloads zu senden. Der visuelle Antwortinspektor erleichtert die Bestätigung, dass die richtige Richtlinie in der richtigen Reihenfolge ausgelöst wurde.

Das erste Projekt wird in wenigen Minuten bereitgestellt. Die schwierigere Arbeit besteht darin, Routen gut zu benennen und zu entscheiden, wo benutzerdefinierte Logik platziert werden soll, was dasselbe Problem ist, das Sie auf jeder Plattform hätten.

Benutzerdefinierte Richtlinien in TypeScript schreiben

Die vorgefertigten Richtlinien decken die gängigen Fälle ab. Für alles andere schreiben Sie eine benutzerdefinierte Richtlinie. Ein typisches Beispiel ist die Anreicherung der Anfrage mit Daten aus einem internen Dienst, bevor sie Ihren Ursprung erreicht:

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

Drei Dinge sind hier erwähnenswert. Erstens ist die Richtlinie eine normale asynchrone Funktion; das Testen ist ein Unit-Test, kein fixture-lastiger Integrationstest. Zweitens kommen Umgebungsvariablen aus context.environment, was typsicher ist und aus Ihren Projekteinstellungen gezogen wird. Drittens führt das Zurückgeben einer Response zu einem Kurzschluss der Pipeline, wodurch Sie Authentifizierungsfehler oder Upstream-Fehler sauber ausdrücken können.

Zuplo-Preisgestaltung im Jahr 2026

Die Preisgestaltung von Zuplo ist für diese Kategorie ungewöhnlich unkompliziert. Drei Pläne:

Die AI Gateway- und Developer Portal-Produkte haben separate Tarife, einschließlich eines Open-Source-Self-Hosted-Portals für 0 $/Monat. Die aktuellen Zahlen finden Sie auf der Zuplo-Preisgestaltungsseite und sollten vor Vertragsunterzeichnung überprüft werden.

Zum Vergleich: AWS API Gateway berechnet 3,50 $ pro Million REST-Anfragen, dann Datenübertragung, dann Lambda-Kosten, wenn Sie Lambda-Integrationen verwenden. Kongs Enterprise-Tier ist benutzerdefiniert und liegt historisch deutlich über Zuplos 1.000 $-Grenze. Allein der kostenlose Tarif macht Zuplo für Projekte in der Frühphase kaum zu übertreffen.

Wann Zuplo die richtige Wahl ist (und wann nicht)

Zuplo ist eine gute Wahl, wenn:

Zuplo ist die falsche Wahl, wenn:

Testen Ihres Zuplo Gateways mit Apidog

Sobald Ihr Gateway in einer Vorschauumgebung live ist, müssen Sie jede Route, jede Richtlinie und jeden Grenzfall testen, bevor Sie sie in die Produktion überführen. Hier zahlt sich ein dedizierter API-Client aus.

Apidog importiert Ihre OpenAPI-Spezifikation direkt, sodass dieselbe Spezifikation, die Ihre Zuplo-Routen antreibt, auch Ihre Testsuite antreibt. Von dort aus können Sie:

Sie können auch die automatisierten Test-Szenarien von Apidog gegen das Gateway ausführen, was schneller ist als das Schreiben von einmaligen Skripten. Wenn Sie Apidog noch nicht verwendet haben, können Sie mit der Apidog VS Code-Erweiterung Anfragen senden, ohne Ihren Editor verlassen zu müssen, und der Leitfaden API-Tests ohne Postman führt Sie durch die Migration, wenn Sie von einem anderen Client kommen. Laden Sie Apidog herunter, um loszulegen.

Häufig gestellte Fragen zum Zuplo API Gateway

Ist Zuplo Open Source?

Die Kern-Gateway-Laufzeit ist proprietär, aber Zuplo hat das Entwicklerportal und mehrere unterstützende Bibliotheken auf GitHub als Open Source veröffentlicht. Wenn Sie eine selbst gehostete Option benötigen, decken das Open-Source-Portal plus eine selbst gehostete Kubernetes-Bereitstellung des Gateways die meisten Anforderungen ab. Die meisten Teams bleiben beim verwalteten Dienst.

Kann Zuplo auf meiner eigenen Infrastruktur laufen?

Ja. Der Enterprise-Plan beinhaltet eine selbst gehostete Kubernetes-Option. Der Kompromiss ist, dass Sie die globale Edge-Bereitstellung aufgeben und den Cluster-Betrieb selbst übernehmen. Für Teams mit strengen Datenresidenzregeln ist dies die richtige Wahl.

Wie vergleicht sich Zuplo mit Cloudflare API Shield?

API Shield ist ein sicherheitsorientiertes Produkt (Schemavalidierung, Missbrauchserkennung, mTLS), das vor jedem Ursprung sitzt. Zuplo ist eine vollständige API-Management-Plattform: Routing, Richtlinien, Entwicklerportal, Monetarisierung, MCP-Unterstützung. Die beiden können koexistieren. Wenn Sie nur Sicherheitssignale benötigen, reicht API Shield aus. Wenn Sie den gesamten Lebenszyklus benötigen, ist Zuplo die Plattform.

Funktioniert Zuplo mit meiner bestehenden OpenAPI-Spezifikation?

Ja. OpenAPI ist die Quelle der Wahrheit in Zuplo. Importieren Sie die Spezifikation, die Routen erscheinen, das Entwicklerportal generiert sich aus derselben Spezifikation, und Anforderungsvalidierungsrichtlinien verwenden dieselben Schemata. Wenn Ihre Spezifikation unordentlich ist, finden Sie dies beim Importprozess heraus.

Kann ich mein Zuplo Gateway KI-Agenten wie Claude oder Codex zugänglich machen?

Ja, über den MCP Server Handler. Sie verweisen den Handler auf Ihre OpenAPI-Spezifikation, wählen aus, welche Operationen freigegeben werden sollen, und das Gateway wird von jedem MCP-kompatiblen Client aufrufbar. Dieselben Authentifizierungs- und Ratenbegrenzungsrichtlinien, die Sie für menschliche Anrufer definiert haben, gelten automatisch.

Wie lange dauert eine Zuplo-Bereitstellung?

Ein Push-to-Deploy-Zyklus dauert typischerweise weniger als sechzig Sekunden für eine Vorschauumgebung. Produktionspromotions sind schneller, da das Artefakt bereits erstellt wurde. Es gibt keine Wartungsfenster; Bereitstellungen sind atomar.

Was passiert, wenn Cloudflare ausfällt?

Zuplo läuft im Edge-Netzwerk von Cloudflare, daher wird ein regionaler Ausfall von Cloudflare diese Region betreffen. Der Enterprise-Plan bietet Multi-Cloud-Failover-Optionen für Teams, die eine Verfügbarkeit von 99,999 % benötigen. Die meisten Teams akzeptieren die Abhängigkeit angesichts der Zuverlässigkeitsbilanz von Cloudflare.

Fazit

Zuplo ist das API-Gateway für Teams, die Unternehmensfunktionen ohne den operativen Aufwand wünschen. TypeScript-native Richtlinien, GitOps-Bereitstellungen, ein automatisch generiertes Entwicklerportal, integrierte Monetarisierung und jetzt MCP-Unterstützung für KI-Agenten machen es zu einer vollständigen Plattform anstatt einer dünnen Routing-Schicht. Der kostenlose Tarif ist großzügig genug für echten Produktionsverkehr, und der Enterprise-Plan deckt den Rest ab.

Wenn Sie evaluieren, führen Sie die dreißigminütige Einrichtung mit einer Ihrer realen APIs durch, lassen Sie sie durch Apidog laufen, um jede Richtlinie zu validieren, und entscheiden Sie auf der Grundlage von Beweisen statt von Marketingseiten. Die Kombination aus einem verwalteten Edge-Gateway und einem leistungsstarken Test-Client ist der schnellste Weg von „wir haben eine API“ zu „wir haben ein Produkt“. Laden Sie Apidog herunter und beginnen Sie mit dem Testen.

button

Praktizieren Sie API Design-First in Apidog

Entdecken Sie eine einfachere Möglichkeit, APIs zu erstellen und zu nutzen

Kostenlos registrierenDownload