---
title: Importieren von OpenAPI / Swagger
slug: docs/de/importieren-von-openapi-swagger
description: Erfahren Sie, wie Sie die Leistungsfähigkeit des OpenAPI-Imports in Archbee für entwicklerzentrierte Produktdokumentation nutzen können. Entdecken Sie die Vorteile, unterstützte Versionen, Authentifizierungsmethoden, das Vorbefüllen von Standardparametern
createdAt: 2021-10-29T07:42:12.000Z
---

## Warum OpenAPI-Import verwenden?

Wenn Ihr Produkt für Entwickler entwickelt wurde oder Ihr Produkt über eine API verfügt, benötigen Sie großartige Produktdokumentation — andernfalls können Sie sich bei Entwicklern nicht durchsetzen.

Sobald Sie Ihre OpenAPI-Datei importieren, liest Archbee sie ein, konvertiert sie in eine ansprechende Benutzeroberfläche und macht sie bereit zum:

- **Öffentlichen Teilen **(auf einer benutzerdefinierten Domain) 
- **Internen Nutzung** mit Ihren Kollegen und Teams

Nach dem Import können Sie Ihre OpenAPI synchronisieren, aktualisieren und testen. Weitere Details finden Sie in den folgenden Abschnitten.

## Regeln und Standardeinstellungen

:::hint{type="info"}
Importierte OpenAPI-Dateien können in Archbee nicht manuell bearbeitet werden.

Um Ihre OpenAPI zu aktualisieren und zu verwalten, prüfen Sie unsere [Synchronisierungsoptionen](docId\:TDV9AARgcEvuWufmu1OqV)
:::

### Unterstützte OpenAPI-Versionen:

Archbee unterstützt derzeit die folgenden OpenAPI-Versionen für den Import:

1. Version 2.0 und 2.0.XX
2. Version 3.0 und 3.0.XX
3. Version 3.1 und 3.1.XX

### Unterstützte Auth-Methoden

Archbee unterstützt derzeit die folgenden Auth-Methoden:

1. [Basic Authentication](https://swagger.io/docs/specification/authentication/basic-authentication/)
2. [API Keys](https://swagger.io/docs/specification/authentication/api-keys/)
3. [Bearer Authentication](https://swagger.io/docs/specification/authentication/bearer-authentication/)

Wenn Sie OpenAPI-Dateien mit anderen Auth-Methoden importieren, werden diese korrekt importiert, und die Auth-Methode wird ignoriert. 

Das bedeutet, dass Sie die gesamte Archbee OpenAPI-Erfahrung erhalten, **außer **der Try It!-Funktion, wenn Ihr Endpunkt eine oben nicht aufgeführte Auth erfordert.

### Weitere Hinweise

1. Wenn Sie in Ihrer OpenAPI "**Standard**"-Parameter definieren und ihnen einen Wert geben, werden das Codebeispiel und das Parameterfeld automatisch mit diesem Wert vorausgefüllt.

   Dies erleichtert es Ihren Nutzern oder Kunden, Ihre API mit [Probier es aus!](docId\:UO3s5ScjS02MY-8RcUfXH) zu testen, ohne alle erforderlichen Parameter aktualisieren zu müssen.

2. Wenn Sie in Ihrer OpenAPI einen "**Beispiel**"-Parameter definieren, wird der Beispielwert auf der linken Seite direkt unter dem API-Parameter angezeigt.

   Dies erleichtert es Ihren Nutzern zu erkennen, welche Art von Eingabe für diesen spezifischen Parameter benötigt wird.

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/fCN8X5XLW-WFI9W1yvi3K_body-light.png)

## Wie funktioniert es?

::::WorkflowBlock
:::WorkflowBlockItem
Importieren Sie Ihre OpenAPI-Datei über **Inhalte importieren**:

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/ZIM8Bq-VEqGvv_aHHjArO_import-content-light.png)

Oder verwenden Sie die Option **Import** in jedem Space:

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/0w0sHacVm8l8N_AFkF4yf_import-option-light.png)

Oder synchronisieren Sie Ihre OpenAPI-Dateien direkt aus Ihrem [GitHub](docId\:AAb0SUiP38At92h5reWuh)-Repository.

Mit Archbees [GitHub-Integration](docId\:AAb0SUiP38At92h5reWuh) können Sie Ihre OpenAPI-Dateien direkt aus Ihrem Repository hinzufügen und synchronisieren.
:::

:::WorkflowBlockItem
Vorschau und [Test](docId\:UO3s5ScjS02MY-8RcUfXH) Ihrer importierten OpenAPI

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/DsF_NDr8yoe62d13qJDP6_test-it-light.png)

Sehen Sie sich Ihre neu importierte OpenAPI mit Archbees [API PROBIER ES AUS!](docId\:UO3s5ScjS02MY-8RcUfXH)-Funktion an und testen Sie sie.
:::

:::WorkflowBlockItem
**Veröffentlichen** oder **teilen** Sie es mit Ihren Kollegen oder Kunden!

Veröffentlichen Sie es in der Vorschau oder auf einer benutzerdefinierten Domain und machen Sie es Ihren Kollegen, Teams oder Nutzern zugänglich. 

Wenn Sie den Inhalt schützen und nur mit ausgewählten Personen teilen möchten, sehen Sie sich unsere Optionen der [Kontrollen für öffentlichen Zugriff](docId\:lX0X8z_IkCDe5V6tsHjkz) für veröffentlichte Portale an.
:::

:::WorkflowBlockItem
Pflegen, synchronisieren und konfigurieren Sie es:

1. [Manuell synchronisieren](docId\:TDV9AARgcEvuWufmu1OqV)
2. [Automatisch über die API synchronisieren](docId\:TDV9AARgcEvuWufmu1OqV)
3. [Sprache des Beispielcodes ändern](docId\:TDV9AARgcEvuWufmu1OqV)
:::
::::

## Hier ist ein Video, wie es funktioniert

::embed[]{url="https://youtu.be/LQ3nEGCcdKg"}