Zum Hauptinhalt springen
Mit Workspace-Integrationen kannst du gemeinsame externe APIs auf Workspace-Ebene aus einer OpenAPI-Spezifikation registrieren. Du importierst eine Spec (URL oder JSON), wählst bis zu 30 Operationen aus und verbindest die API einmal in deinem Workspace. Jede App in diesem Workspace kann dann diese genehmigten Operationen über base44.integrations.custom.call() aufrufen, anstatt eine eigene Verbindung einzurichten. Das funktioniert sowohl für interne APIs als auch für Partner-APIs, auf die dein Team angewiesen ist.
Integrationen in einem Workspace in Base44
Diese Integrationen sind so konzipiert, dass sie sicher und zuverlässig sind. Sensible Auth-Header werden als verschlüsselte Workspace-Secrets gespeichert und niemals an den Browser zurückgesendet. Zur Laufzeit werden Aufrufe serverseitig mit Schutz vor Server-Side Request Forgery (SSRF) weitergeleitet, und Workspace-Header haben Vorrang, damit Apps sie nicht überschreiben können. Das Bearbeiten einer Integration verwendet die gespeicherte Spezifikation statt der Live-URL, und das Speichern wird blockiert, wenn Header nicht geladen werden können, damit du sie nicht versehentlich verlierst.
Wichtig:
  • Der Zugriff auf Workspace-Integrationen ist auf Workspace-Admins und -Owner ab dem Builder-Tarif beschränkt.
  • Jedes Mitglied im Workspace kann eine bestehende Workspace-Integration in seinen Apps verwenden, selbst im kostenlosen Tarif.

​
Workspace-Integrationen verstehen

Eine Workspace-Integration ist eine gemeinsame Verbindung von deinem Workspace zu einer externen oder internen API, wie einem CRM, Support-System oder benutzerdefinierten Backend. Du definierst sie einmal in deinem Workspace aus einer OpenAPI- oder Swagger-Spezifikation, wählst aus, welche Operationen erlaubt sind, und jede kompatible App in diesem Workspace kann diese Operationen aufrufen. Das hält die Konfiguration an einem Ort und macht es einfacher, die externen Systeme zu verwalten, auf die dein Team angewiesen ist. Workspace-Integrationen sind nützlich, wenn du:
  • Dieselbe externe oder interne API in mehreren Apps im selben Workspace verwenden möchtest.
  • Sensible Details wie API-Schlüssel und Tokens an einem sicheren Ort behalten möchtest, verwaltet als Workspace-Secrets.
  • Einschränken möchtest, welche Endpoints verfügbar sind, damit Apps nur genehmigte, spec-definierte Operationen aufrufen.
  • Eine klare Trennung zu Ein-Klick-OAuth-Connectors behalten möchtest, da Workspace-Integrationen Workspace-verwaltet und spec-getrieben sind.
  • Klar machen möchtest, auf welche externen Systeme dein Workspace angewiesen ist.

​
Eine Integration erstellen

Erstelle eine benutzerdefinierte Workspace-Integration, wenn du eine neue externe API für deine Apps verfügbar machen möchtest und diese API über eine OpenAPI- oder Swagger-Spezifikation verfügt. Base44 liest die Spezifikation, lässt dich die Endpoints auswählen, die du verfügbar machen möchtest, und erstellt eine wiederverwendbare Integration für deinen Workspace.
Bevor du beginnst: Stelle sicher, dass du Zugriff auf eine gültige OpenAPI- oder Swagger-Spezifikation für die API hast, die du verwenden möchtest. Du kannst sie entweder auf einer öffentlichen URL hosten oder das JSON kopieren.

​
Schritt 1 | Eine neue Integration hinzufügen

  1. Klicke oben links in deinem Konto auf deinen Workspace-Namen.
  2. Klicke auf Settings.
  3. Klicke auf Integrations.
  4. Klicke auf New Integration.
  5. Wähle, wie du deine API-Spezifikation bereitstellen möchtest:
    • From URL: Gib die öffentliche URL deiner OpenAPI- oder Swagger-Datei in das Feld OpenAPI Specification URL ein, zum Beispiel https://api.example.com/openapi.json.
    • Paste JSON: Füge die vollständige JSON-Definition deiner OpenAPI- oder Swagger-Spezifikation in den Editor ein.
  6. Klicke auf Continue.
Eine benutzerdefinierte Integration in einem Workspace hinzufügen

​
Schritt 2 | Endpoints zum Verfügbarmachen auswählen

Wähle bis zu 30 Endpoints für deine Integration aus. So wählst du Endpoints aus:
  1. Überprüfe die Liste der Endpoints, die Base44 aus deiner Spezifikation findet. Du kannst das Suchfeld verwenden, um bestimmte Pfade oder Operationen nach Methode oder Pfadname zu finden.
  2. Aktiviere die Kontrollkästchen für die Endpoints, die du in deinem Workspace verfügbar machen möchtest.
  3. Klicke auf Continue.
Die Endpoints auswählen, die für deine Workspace-Integration verfügbar gemacht werden sollen

​
Schritt 3 | Deine Integration konfigurieren

Konfiguriere deine Integrationsdetails, lege die Basis-URL fest und füge alle benutzerdefinierten Header hinzu, die deine API benötigt. Sensible Header-Werte bleiben geschützt. Häufige Auth-Header wie authorization, x-api-key, api-key, x-auth-token, x-access-token, x-secret-key, bearer, secret, password und credential werden immer als Secrets behandelt. Ihre Werte werden als verschlüsselte Workspace-Secrets gespeichert, niemals an den Browser zurückgesendet und werden als “sensitive – delete to change” angezeigt, wenn du die Integration bearbeitest. So konfigurierst du deine Integration:
  1. Lege die Details für deine Integration fest:
    • Slug: Gib einen URL-freundlichen Identifier für die Integration ein, zum Beispiel my-api.
    • Name: Gib den Anzeigenamen ein, der in der Liste deiner Workspace-Integrationen erscheint.
    • Description: Beschreibe, was die Integration tut, damit Teammitglieder wissen, wann sie sie verwenden sollen.
    • Base URL: Bestätige oder aktualisiere die Basis-URL für deine API.
  2. Wenn deine API Header benötigt, die mit jeder Anfrage gesendet werden müssen, füge sie im Abschnitt Custom Headers hinzu:
    1. Klicke auf Add Header.
    2. Gib den Header-Namen ein, wie Authorization oder X-API-Key.
    3. Gib den Header-Wert ein, wie deinen API-Schlüssel oder Token.
    4. Verwende das Sichtbarkeitssymbol, um den Header-Wert nach Bedarf zu verbergen oder anzuzeigen.
  3. Überprüfe die Liste der ausgewählten Endpoints am unteren Rand des Dialogs.
  4. Klicke auf Create Integration.
Deine Workspace-Integration konfigurieren

​
Workspace-Integrationen verwalten

Nachdem du eine Workspace-Integration erstellt hast, erscheint sie im Tab Integrations deines Workspace. Von dort aus kannst du ihre Details anzeigen, Einstellungen bearbeiten oder sie entfernen, wenn du sie nicht mehr brauchst.

​
Integrationsdetails anzeigen

  1. Klicke oben links in deinem Konto auf deinen Workspace-Namen.
  2. Klicke auf Settings.
  3. Klicke auf Integrations.
  4. Sieh dir die Integration an, die du prüfen möchtest, und erweitere die Endpoints.

​
Eine Integration bearbeiten

  1. Klicke oben links in deinem Konto auf deinen Workspace-Namen.
  2. Klicke auf Settings.
  3. Klicke auf Integrations.
  4. Klicke auf das Symbol More Actions auf der Integrations-Karte.
  5. Klicke auf Edit.
  6. Aktualisiere die benötigten Felder und speichere deine Änderungen.
Eine Workspace-Integration bearbeiten
Wenn du zusätzliche Endpoints aus derselben API verfügbar machen musst, ziehe in Betracht, eine neue Integration zu erstellen oder die bestehende zu aktualisieren, basierend darauf, wie Apps sie verwenden sollen.

​
Eine Integration löschen

  1. Klicke oben links in deinem Konto auf deinen Workspace-Namen.
  2. Klicke auf Settings.
  3. Klicke auf Integrations.
  4. Klicke auf das Symbol More Actions auf der Integrations-Karte.
  5. Klicke auf Delete.
  6. Klicke erneut auf Delete, um zu bestätigen, dass du sie aus dem Workspace entfernen möchtest.
Eine Workspace-Integration löschen
Wichtig: Das Löschen einer Workspace-Integration kann alle App-Level-Integrationen brechen, die von ihr abhängen. Stelle sicher, dass du aktive Apps überprüfst, bevor du eine gemeinsame Integration entfernst.

​
FAQs

Klicke unten auf eine Frage, um mehr über Workspace-Integrationen zu erfahren.
Nachdem du eine Workspace-Integration erstellt hast, können alle neuen Apps, die du in diesem Workspace baust, sie verwenden.Wenn du eine neue App erstellst, überprüft Base44 deine Workspace-Integrationen. Wenn du eines dieser Systeme in deinem ersten Prompt erwähnst, verwendet es automatisch die passende Workspace-Integration. Wenn du zum Beispiel bereits eine GitHub API-Integration hinzugefügt hast und sagst “Create an app based on my GitHub issues”, verwendet Base44 die GitHub-Integration, die für den Workspace konfiguriert ist, ohne dass du sie auswählen musst.Du kannst dann überprüfen und anpassen, wie die App diese Integration verwendet, über die Integrations-Einstellungen der App.
Um Workspace-Integrationen zu erstellen oder zu verwalten, musst du Workspace-Owner oder -Admin im Builder-Tarif oder höher sein, mit Zugriff auf den Tab Integrations in deinen Workspace-Einstellungen. Wenn du den Button Add Integration oder Bearbeitungsoptionen nicht siehst, wende dich an deinen Workspace-Admin und bitte ihn, entweder deine Rolle zu aktualisieren oder die Integration für dich zu erstellen.
Wenn der API-Owner die Spezifikation an der von dir verwendeten URL aktualisiert, können sich die Details, die Base44 daraus liest, beim nächsten Aktualisieren oder Neuerstellen der Integration ändern. Wenn du weißt, dass sich die Spec geändert hat, überprüfe deine Workspace-Integration und prüfe, ob die verfügbar gemachten Endpoints noch dem entsprechen, was deine Apps erwarten.
Header-Werte wie API-Schlüssel und Tokens werden als Teil der Workspace-Integrationskonfiguration gespeichert. Nur Teammitglieder mit Berechtigung zur Verwaltung von Workspace-Integrationen können diese Werte anzeigen oder bearbeiten. Verwende das Sichtbarkeitssymbol im Konfigurationsschritt, um Werte auf dem Bildschirm zu verbergen, wenn du in gemeinsamen Räumen arbeitest.
Ja. Du kannst mehrere Workspace-Integrationen erstellen, die auf dieselbe externe API zeigen. Zum Beispiel kannst du separate Integrationen für Sandbox- und Produktionsumgebungen oder für verschiedene Sätze von Endpoints erstellen, die von verschiedenen Apps verwendet werden.
Wenn du einen Schlüssel oder ein Token rotieren musst, generiere die neue Anmeldedaten zuerst im externen System. Bearbeite dann die Workspace-Integration, aktualisiere den relevanten Header-Wert mit dem neuen Schlüssel oder Token und speichere deine Änderungen. Nachdem du die Workspace-Integration aktualisiert hast, beginnen Apps, die sie verwenden, automatisch den neuen Wert zu senden.
Überprüfe, ob die URL direkt auf eine gültige OpenAPI- oder Swagger-JSON- oder YAML-Datei zeigt und dass sie öffentlich von deinem Browser zugänglich ist. Wenn die Datei hinter Authentifizierung liegt oder als HTML bereitgestellt wird, kann Base44 sie nicht parsen.Wenn du immer noch Fehler siehst, wechsle zur Paste-JSON-Option, kopiere das rohe JSON deiner Spezifikation und versuche es erneut.Für einen schnellen Test kannst du auch eine bekannte gültige Spec wie eine öffentliche Beispiel-API ausprobieren, um zu bestätigen, dass der Flow funktioniert.
Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.