Produkt

Funktionen des API Developer Portals
von der Spec bis zur Freigabe.

API Portal begleitet eine API von der ersten Spec bis zur Abschaltung. Die Plattform trägt den Alltag der API-Teams, Governance regelt Zugriffe und Abläufe, und die Enterprise-Funktionen bringen das Portal in Organisationen mit vielen Business Units.

app.api-portal.io/catalog
RESTv3.0
Payment API
GraphQL
User Service
AsyncAPI
Event Stream
RESTBeta
Search API

// Ablauf

Wie wird aus einer Spec eine nutzbare API?

Jeder Schritt gehört zu einer eigenen Funktion, und was ein Schritt erzeugt, nutzt der nächste.

1

Spec hochladen

Du lädst eine OpenAPI-, AsyncAPI- oder GraphQL-Spec hoch oder deployst sie per CLI aus der Pipeline.

2

Im Katalog finden

Der API-Katalog nimmt die Spec mit Owner und Version auf, sodass andere Teams sie über die Suche finden.

3

Im Explorer testen

Aus der Spec entsteht interaktive Dokumentation, in der Konsumenten Requests direkt im Browser ausprobieren.

4

Versionieren und prüfen

Der Linter prüft jede Spec gegen eure Regeln, und der Versionsvergleich zeigt Breaking Changes vor dem Release.

5

Zugriff freigeben

Rollen und Business Groups legen fest, wer eine API sehen und nutzen darf.

Erste Schritte mit API Portal →

// Plattform

Plattform für den Alltag der API-Teams

Sechs Funktionen rund um die Spec, vom Katalog bis zum Linter in der CI.

// Governance

Governance für Zugriffe und Abläufe

Wer eine API sehen darf und wie APIs zusammenspielen, regeln zwei Funktionen.

// Enterprise

Enterprise für viele Teams und Marken

Große Organisationen brauchen mehr als ein Portal und oft mehr als einen Auftritt.

// Formate

Acht Spec-Formate in einem Katalog

REST, Events, SOAP, OData, gRPC und GraphQL liegen im selben Katalog, und Entwickler finden jede Schnittstelle über dieselbe Suche.

OpenAPI und Swagger

OpenAPI 3.0, 3.1 und 3.2 sowie Swagger 2.0. Wie der Umstieg älterer Specs auf 3.x gelingt, zeigt unser Ratgeber.

AsyncAPI

Event-getriebene Schnittstellen wie Kafka- oder MQTT-Streams, in AsyncAPI 2.0 bis 2.6, 3.0 und 3.1.

Arazzo

Workflows über mehrere APIs hinweg, beschrieben in Arazzo 1.0 und 1.1.

RAML

Bestehende Specs in RAML 0.8 und 1.0 bleiben im selben Katalog nutzbar.

SOAP / WSDL

SOAP-Services aus WSDL 1.1 und 2.0, mit SOAP 1.1 und 1.2.

OData

OData 4.0 und 4.01 als CSDL XML oder JSON, dazu ältere Services von 1.0 bis 3.0.

Protocol Buffers und gRPC

gRPC-Services aus proto2, proto3 und den Editions 2023 und 2024.

GraphQL

GraphQL-Schemas im selben Katalog wie REST und Events.

// FAQ

Häufige Fragen zu den Funktionen

Weitere Fragen beantwortet unser Team gern im Gespräch.

Vertrieb kontaktieren
Im Kern sind es fünf. Ein Katalog macht vorhandene APIs auffindbar, und interaktive Dokumentation erlaubt Konsumenten, sie sofort auszuprobieren. Versionierung und Versionsvergleich halten Änderungen nachvollziehbar, ein Linter sorgt für einheitliche Specs, und die Zugriffskontrolle regelt, wer welche API sieht. In großen Organisationen kommen eigene Portale je Business Unit und ein Auftritt unter eigener Marke hinzu.
Der Linter prüft eine Spec gegen eure Regeln, bevor sie als neue Version veröffentlicht wird. Die Versionierung vergibt dann die Versionsnummer nach SemVer und schreibt den Changelog. Der Versionsvergleich zeigt zwischen zwei Versionen, welche Änderungen Breaking Changes sind, damit Konsumenten ihre Migration planen können.
Enterprise Portale regeln, wie viele Portale es gibt und wem sie gehören. Jede Business Unit bekommt ein eigenes Portal mit eigener Datenbank. Das White-Label Portal regelt, wie ein Portal aussieht, also Logo, Favicon, Name, Theme und Domain.
Im Trial nutzt du 14 Tage lang den vollen Funktionsumfang. Starter umfasst bis zu 5 APIs mit automatischer Dokumentation und 3 Teammitgliedern. Professional bringt unbegrenzte APIs, Versionierung mit Changelog, Zugriffskontrolle und 25 Teammitglieder mit. SSO, SAML und dedizierten Support gibt es im Enterprise-Plan, ein SLA auf Anfrage. Die Preise nennt dir der Vertrieb.

Teste alle Funktionen mit deinen Specs

Der Trial läuft 14 Tage mit vollem Funktionsumfang und ohne Kreditkarte. Für einen Termin mit unserem Team genügt eine kurze Nachricht.