Konnektor für Integration

Der Datenkatalog für OpenAPI, dem Ihr ganzes Team vertrauen kann.

Der OpenAPI-Konnektor von Dawiso macht aus jedem Swagger- oder OpenAPI-Schema einen durchsuchbaren Datenkatalog: jeden Endpunkt, jeden Parameter, jede Antwort und jedes verschachtelte Modell, mit einstellbarer Tiefe der $ref-Auflösung.

Zur Dokumentation

Live-Konnektor Stabiler Konnektor

OpenAPI

Dawiso

Nur Metadaten · Ihre Daten verlassen die Quelle nie

Typ: Spezifikation einer REST API
Auth: Öffentliche oder für DIR erreichbare Schema-URL
Sync: Geplant, nach Schema
Richtung: Nur lesend · Metadaten

Zuerst das Wichtigste

Was ist ein Konnektor?

Nur Metadaten Nur lesender Zugriff Inkrementeller Sync Systemübergreifende Lineage

Ein Konnektor ist die Brücke zwischen einem Werkzeug in Ihrem Stack und dem Katalog, der Ihnen einen einheitlichen Blick darauf gibt. Ist ein Konnektor eingerichtet, greift er nach Zeitplan auf das Quellsystem zu, liest die Metadaten aus - Schemas, Tabellen, Dashboards, Jobs, Verantwortlichkeiten, Data Lineage - und bildet sie im Katalog ab. Ihre eigentlichen Zeilen und Werte bleiben, wo sie sind.

Konnektoren sind der Grund, warum ein Datenkatalog Fragen wie „Welches Power-BI-Dashboard hängt von dieser Snowflake-Tabelle ab?“ oder „Wer verantwortet das orders-Topic in Kafka?“ beantworten kann - automatisch, ohne dass jemand eine Excel-Liste pflegen muss.

Drei Eigenschaften unterscheiden einen guten Konnektor von einem brüchigen: Er sollte nur lesend und sicher sein, er sollte inkrementell arbeiten, damit nicht bei jeder Aktualisierung ein vollständiger Neuscan nötig ist, und er sollte Data Lineage über Systemgrenzen hinweg auflösen, nicht nur innerhalb eines Werkzeugs.

Über die Plattform

Was ist OpenAPI?

OpenAPI, 2010 als Swagger gestartet, ist der Standard, mit dem REST APIs beschrieben werden. Die OpenAPI Initiative ist bei der Linux Foundation angesiedelt und zählt Google, Microsoft, IBM und Capital One zu ihren Gründungsmitgliedern. Wenn Ihr Unternehmen APIs ausliefert, gibt es dazu mit hoher Wahrscheinlichkeit ein OpenAPI-Dokument.

APIs bleiben für den Datenkatalog oft unsichtbar, selbst wenn die Hälfte der Daten im Warehouse aus ihnen stammt. Eine Tabelle aus dem Salesforce-Abgleich begann als fünf API-Aufrufe; ein Marketing-Datensatz ist ein einziger paginierter REST-Endpunkt. Die Endpunkte und Schemas hinter diesen Daten werden selten dort dokumentiert, wo die Nutzer aus den Fachbereichen sie finden. Genau dort setzt der OpenAPI-Datenkatalog von Dawiso an: nur lesend, nur Metadaten, und plattformübergreifend.

Architektur

So verbindet sich Dawiso mit OpenAPI

Eine kleine, nur lesende Rolle aufseiten von OpenAPI. Der Dawiso-Scanner holt die Metadaten nach Zeitplan. Alles landet in Ihrem Katalog, fachlich lesbar.

Quelle

OpenAPI-Schema-URL

Pfade und Operationen
Parameter und Antworten
Schemas der Komponenten
Referenzgraph der $ref

REST · JDBC

Dawiso-Scanner

Metadatenzugriff nur lesend

Schema- und Objekterkennung
Auflösung von Abhängigkeiten
SQL-Flow-Parsing (optional)
Sampling nach Opt-in

Intern

Katalog

Dawiso-Plattform

Durchsuchbare Metadaten
Data Lineage und Verantwortlichkeiten
Business Glossary
Richtlinien und Klassifizierungen

Verbindungsdetails

Protokoll: OpenAPI- oder Swagger-Schemadatei (JSON oder YAML) über HTTPS
Authentifizierung: Öffentliche oder für DIR erreichbare Schema-URL · keine Zugangsdaten zur laufenden API nötig
Lineage: API-Endpunkte, Parameter, Antworten und Komponentenschemas werden zu durchsuchbaren Katalog-Assets, deren Verantwortung in Dawiso dokumentiert ist

Einrichtung

OpenAPI in 4 Schritten verbinden

01

OpenAPI-Schema veröffentlichen

Die meisten API-Frameworks erzeugen das Schema automatisch: FastAPI unter /openapi.json, Spring Boot über springdoc, ASP.NET über Swashbuckle. Notieren Sie die vollständige Schema-URL.
02

Verbindung anlegen

Tragen Sie die Schema-URL in Dawiso ein. Für interne APIs hinter einer Firewall nutzen Sie eine private Verbindung und leiten über die Dawiso Integration Runtime.
03

Tiefe wählen

Stellen Sie die maximale Tiefe der $ref-Auflösung ein (0 bis 5). Tiefe 2 deckt die meisten sauberen Schemas ab; erhöhen Sie sie, wenn Ketten wie User zu Address zu Country vollständig sichtbar sein sollen.
04

Ingestion starten

Der geplante Sync liest das Schema erneut und aktualisiert Endpunkte, Parameter und Komponentenschemas. Alte Endpunkte bleiben im Katalog, bis Sie bestätigen, dass es sie nicht mehr gibt.

Funktionen

Das bekommen Sie mit dem Konnektor für OpenAPI

Katalog für Endpunkte und Schemas

Jeder Pfad, jede Operation, jeder Parameter und jedes Antwortmodell ist in Dawiso durchsuchbar. Finden Sie mit zwei Klicks, welche API customerId offenlegt, statt ein Repository zu durchsuchen.
Parameter und Antworten

Parameter in Pfad, Query und Body sowie die Antwort-Nutzlast je Statuscode werden katalogisiert. So hat die Frage, was GET /customers zurückgibt, eine Antwort, ohne die Spezifikation zu öffnen.
Auflösung verschachtelter $ref

Stellen Sie die Tiefe von 0 bis 5 ein. Dawiso folgt den $ref-Ketten, sodass eine Verschachtelung wie UserList, darin User, darin Address, darin Country, vollständig katalogisiert wird.
Verantwortung für APIs

Weisen Sie APIs Verantwortliche und Stewards zu, genau wie Tabellen. Das Team, das die API ausliefert, steht für sie gerade.
Zertifizierung und Prüfung

Stufen Sie Endpunkte als zertifiziert ein oder markieren Sie sie im Katalog als in Prüfung. Die Abnehmenden sehen den Status direkt neben dem Endpunkt.
Keine Aufrufe zur Laufzeit

Dawiso liest ausschließlich das OpenAPI-Dokument. Es braucht weder API-Schlüssel noch OAuth-Zugangsdaten noch ein Kontingent an Aufrufen gegen Ihren laufenden Dienst.

Geschäftlicher Nutzen

Warum Teams den Konnektor für OpenAPI aktivieren

Durchsuchbar
Endpunkte verstecken sich nicht mehr im Repository

Finden Sie mit zwei Klicks, welche API ein bestimmtes Feld offenlegt, statt eine Codebasis zu durchsuchen. Das Schema ist dort dokumentiert, wo die Fachbereiche es lesen können.
API-first
APIs im selben Katalog wie Tabellen

Serviceorientierte Unternehmen brauchen kein zweites Werkzeug für API-Dokumentation mehr. Endpunkte stehen neben Tabellen, Berichten und Fachbegriffen.
Ohne Schlüssel
Nur das Schema, kein Zugriff zur Laufzeit

Dawiso liest das OpenAPI-Dokument, nie Ihren laufenden Dienst. Keine Zugangsdaten, kein Kontingent an Aufrufen, nichts, was Security prüfen müsste.

Bereit, Ihr OpenAPI zu katalogisieren?

Den Konnektor richten Sie an einem Nachmittag ein. Ihren ersten Lineage-Graph sehen Sie noch am selben Tag.

Zur Dokumentation

Häufige Fragen

Noch Fragen? Sprechen Sie mit unserem Team ->

Was sind Metadaten in einer API?

API-Metadaten beschreiben Endpunkte, Parameter, Schemas und Antworten, also genau das, was eine OpenAPI-Spezifikation festhält. Dawiso liest Ihre OpenAPI-Spezifikationen nur lesend und katalogisiert jeden Endpunkt und jedes Datenmodell mit Verantwortlichen und Status der Zertifizierung.

Funktioniert OpenAPI mit einem Datenkatalog?

Ja. Dawiso liest OpenAPI-Spezifikationen ein und macht aus dokumentierten Endpunkten und Schemas katalogisierte, durchsuchbare Assets, die neben dem Rest Ihrer Daten in einem Katalog stehen.

Welche OpenAPI-Versionen werden unterstützt?

Unterstützt werden Swagger 2.0 sowie OpenAPI 3.x als JSON oder YAML. Geben Sie die vollständige URL zur Schemadatei an (zum Beispiel https://api.your-company.com/v3/api-docs).

Ruft Dawiso die API zur Laufzeit auf?

Nein. Dawiso liest ausschließlich das OpenAPI-Schemadokument. Es werden keine Anfragen zur Laufzeit gestellt, also braucht die Integration weder API-Schlüssel noch OAuth-Zugangsdaten noch ein Kontingent an Aufrufen gegen Ihren laufenden Dienst.

Wofür ist die Tiefe gedacht?

Sie steuert, wie weit Dawiso die $ref-Ketten innerhalb des Schemas auflöst. Tiefe 0 hält Referenzen fest, ohne sie aufzulösen; Tiefe 5 als Maximum folgt der Kette vollständig. Mehr Tiefe bedeutet mehr Detail und längeres Einlesen.

Kann ich interne APIs hinter einer Firewall katalogisieren?

Ja. Nutzen Sie eine private Verbindung und die Dawiso Integration Runtime (DIR), die das Schema aus Ihrem Netz heraus abruft und nur Metadaten an den Dawiso-Tenant zurückschickt.