diff --git a/docs/de/docs/index.md b/docs/de/docs/index.md
index 5d5b17fa0..f5df8df3d 100644
--- a/docs/de/docs/index.md
+++ b/docs/de/docs/index.md
@@ -18,7 +18,7 @@
- 
+
@@ -33,20 +33,20 @@
---
-FastAPI ist ein modernes, schnelles (hohe Performanz) Web-Framework zum Erstellen von APIs mit Python, basierend auf Standard-Python-Typhinweisen.
+FastAPI ist ein modernes, schnelles (hoch performantes) Webframework zur Erstellung von APIs mit Python auf Basis von Standard-Python-Typhinweisen.
-Die wichtigsten Features:
+Seine Schlüssel-Merkmale sind:
* **Schnell**: Sehr hohe Performanz, auf Augenhöhe mit **NodeJS** und **Go** (dank Starlette und Pydantic). [Eines der schnellsten verfügbaren Python-Frameworks](#performance).
* **Schnell zu entwickeln**: Erhöhen Sie die Geschwindigkeit bei der Entwicklung von Features um etwa 200 % bis 300 %. *
-* **Weniger Bugs**: Reduzieren Sie ca. 40 % der menschlich (vom Entwickler) verursachten Fehler. *
-* **Intuitiv**: Hervorragende Editor-Unterstützung. Completion überall. Weniger Zeit mit Debugging verbringen.
-* **Einfach**: Darauf ausgelegt, einfach zu verwenden und zu erlernen. Weniger Zeit mit der Dokumentation verbringen.
-* **Kurz**: Code-Duplizierung minimieren. Mehrere Features aus jeder Parameterdeklaration. Weniger Bugs.
-* **Robust**: Produktionsreifen Code erhalten. Mit automatischer interaktiver Dokumentation.
-* **Standardbasiert**: Basierend auf (und vollständig kompatibel mit) den offenen Standards für APIs: OpenAPI (früher bekannt als Swagger) und JSON Schema.
+* **Weniger Bugs**: Verringern Sie die von Menschen (Entwicklern) verursachten Fehler um etwa 40 %. *
+* **Intuitiv**: Hervorragende Editor-Unterstützung. Code-Vervollständigung überall. Weniger Zeit mit Debuggen verbringen.
+* **Einfach**: So konzipiert, dass es einfach zu benutzen und zu erlernen ist. Weniger Zeit mit dem Lesen von Dokumentation verbringen.
+* **Kurz**: Minimieren Sie die Verdoppelung von Code. Mehrere Features aus jeder Parameterdeklaration. Weniger Bugs.
+* **Robust**: Erhalten Sie produktionsreifen Code. Mit automatischer, interaktiver Dokumentation.
+* **Standards-basiert**: Basierend auf (und vollständig kompatibel mit) den offenen Standards für APIs: OpenAPI (früher bekannt als Swagger) und JSON Schema.
-* Schätzung basierend auf Tests mit einem internen Entwicklungsteam, das Produktionsanwendungen erstellt.
+* Schätzung basierend auf Tests in einem internen Entwicklungsteam, das Produktionsanwendungen erstellt.
## Sponsoren { #sponsors }
@@ -63,51 +63,51 @@ Die wichtigsten Features:
-Weitere Sponsoren
+Andere Sponsoren
## Meinungen { #opinions }
-„_[...] Ich nutze **FastAPI** derzeit sehr viel. [...] Ich plane sogar, es für alle **ML-Services** meines Teams bei **Microsoft** zu verwenden. Einige davon werden in das Kernprodukt **Windows** integriert und einige in **Office**-Produkte._“
+„_[...] Ich verwende **FastAPI** heutzutage sehr oft. [...] Ich habe tatsächlich vor, es für alle **ML-Services meines Teams bei Microsoft** zu verwenden. Einige davon werden in das Kernprodukt **Windows** und einige **Office**-Produkte integriert._“
-
+Kabir Khan –
Microsoft (Ref)Piero Molino, Yaroslav Dudin und Sai Sumanth Miryala -
Uber (Ref.)Piero Molino, Yaroslav Dudin, und Sai Sumanth Miryala –
Uber (Ref)Kevin Glisson, Marc Vilanova, Forest Monsen -
Netflix (Ref.)Kevin Glisson, Marc Vilanova, Forest Monsen –
Netflix (Ref)Deon Pillsbury –
Cisco (Ref)
-Wenn Sie eine CLI-App bauen, die im Terminal statt als Web-API verwendet wird, sehen Sie sich **Typer** an.
+Wenn Sie eine CLI-Anwendung für das Terminal erstellen, anstelle einer Web-API, schauen Sie sich **Typer** an.
-**Typer** ist FastAPIs kleiner Bruder. Und es soll das **FastAPI der CLIs** sein. ⌨️ 🚀
+**Typer** ist die kleine Schwester von FastAPI. Und es soll das **FastAPI der CLIs** sein. ⌨️ 🚀
-## Voraussetzungen { #requirements }
+## Anforderungen { #requirements }
FastAPI steht auf den Schultern von Giganten:
-* Starlette für die Web-Teile.
-* Pydantic für die Daten-Teile.
+* Starlette für die Webanteile.
+* Pydantic für die Datenanteile.
## Installation { #installation }
@@ -144,7 +144,7 @@ $ pip install "fastapi[standard]"
## Beispiel { #example }
-### Erstellen { #create-it }
+### Erstellung { #create-it }
Erstellen Sie eine Datei `main.py` mit:
@@ -167,9 +167,9 @@ def read_item(item_id: int, q: Union[str, None] = None):
```
-Oder async def verwenden ...
+Oder verwenden Sie async def ...
-Wenn Ihr Code `async` / `await` verwendet, nutzen Sie `async def`:
+Wenn Ihr Code `async` / `await` verwendet, benutzen Sie `async def`:
```Python hl_lines="9 14"
from typing import Union
@@ -191,11 +191,11 @@ async def read_item(item_id: int, q: Union[str, None] = None):
**Hinweis**:
-Wenn Sie es nicht wissen, sehen Sie sich den Abschnitt „In Eile?“ über `async` und `await` in der Dokumentation an.
+Wenn Sie das nicht kennen, schauen Sie sich den Abschnitt _„In Eile?“_ über `async` und `await` in der Dokumentation an.
-### Ausführen { #run-it }
+### Starten { #run-it }
Starten Sie den Server mit:
@@ -227,36 +227,36 @@ INFO: Application startup complete.
-Über den Befehl fastapi dev main.py ...
+Was der Befehl fastapi dev main.py macht ...
-Der Befehl `fastapi dev` liest Ihre Datei `main.py`, erkennt die **FastAPI**-App darin und startet einen Server mit Uvicorn.
+Der Befehl `fastapi dev` liest Ihre `main.py`-Datei, erkennt die **FastAPI**-App darin und startet einen Server mit Uvicorn.
-Standardmäßig startet `fastapi dev` mit aktiviertem Auto-Reload für lokale Entwicklung.
+Standardmäßig wird `fastapi dev` mit aktiviertem Auto-Reload für die lokale Entwicklung gestartet.
-Mehr dazu in der FastAPI-CLI-Dokumentation.
+Sie können mehr darüber in der FastAPI CLI Dokumentation lesen.
-### Prüfen { #check-it }
+### Es testen { #check-it }
Öffnen Sie Ihren Browser unter http://127.0.0.1:8000/items/5?q=somequery.
-Sie sehen die JSON-Response:
+Sie sehen die JSON-Response als:
```JSON
{"item_id": 5, "q": "somequery"}
```
-Sie haben bereits eine API erstellt, die:
+Sie haben bereits eine API erstellt, welche:
-* HTTP-Requests in den _Pfade(n)_ `/` und `/items/{item_id}` empfängt.
-* Beide _Pfade_ nehmen `GET`-Operationen (auch bekannt als HTTP-_Methoden_) an.
+* HTTP-Requests auf den _Pfaden_ `/` und `/items/{item_id}` entgegennimmt.
+* Beide _Pfade_ nehmen `GET` Operationen (auch bekannt als HTTP-_Methoden_) entgegen.
* Der _Pfad_ `/items/{item_id}` hat einen _Pfad-Parameter_ `item_id`, der ein `int` sein sollte.
* Der _Pfad_ `/items/{item_id}` hat einen optionalen `str`-_Query-Parameter_ `q`.
### Interaktive API-Dokumentation { #interactive-api-docs }
-Gehen Sie jetzt zu http://127.0.0.1:8000/docs.
+Gehen Sie nun auf http://127.0.0.1:8000/docs.
Sie sehen die automatische interaktive API-Dokumentation (bereitgestellt von Swagger UI):
@@ -264,15 +264,15 @@ Sie sehen die automatische interaktive API-Dokumentation (bereitgestellt von http://127.0.0.1:8000/redoc.
+Und jetzt gehen Sie auf http://127.0.0.1:8000/redoc.
Sie sehen die alternative automatische Dokumentation (bereitgestellt von ReDoc):
-## Beispiel aktualisieren { #example-upgrade }
+## Beispiel Aktualisierung { #example-upgrade }
-Ändern Sie nun die Datei `main.py`, um einen Body von einem `PUT`-Request zu empfangen.
+Ändern Sie jetzt die Datei `main.py`, um den Body eines `PUT`-Requests zu empfangen.
Deklarieren Sie den Body mit Standard-Python-Typen, dank Pydantic.
@@ -310,37 +310,37 @@ Der `fastapi dev`-Server sollte automatisch neu laden.
### Interaktive API-Dokumentation aktualisieren { #interactive-api-docs-upgrade }
-Gehen Sie jetzt zu http://127.0.0.1:8000/docs.
+Gehen Sie jetzt auf http://127.0.0.1:8000/docs.
* Die interaktive API-Dokumentation wird automatisch aktualisiert, einschließlich des neuen Bodys:
-* Klicken Sie auf die Schaltfläche „Try it out“, damit können Sie die Parameter ausfüllen und direkt mit der API interagieren:
+* Klicken Sie auf den Button „Try it out“, damit können Sie die Parameter ausfüllen und direkt mit der API interagieren:
-
+
-* Klicken Sie dann auf die Schaltfläche „Execute“, die Benutzeroberfläche kommuniziert mit Ihrer API, sendet die Parameter, erhält die Ergebnisse und zeigt sie auf dem Bildschirm an:
+* Klicken Sie dann auf den Button „Execute“, die Benutzeroberfläche wird mit Ihrer API kommunizieren, sendet die Parameter, holt die Ergebnisse und zeigt sie auf dem Bildschirm an:
-
+
### Alternative API-Dokumentation aktualisieren { #alternative-api-docs-upgrade }
-Und jetzt gehen Sie zu http://127.0.0.1:8000/redoc.
+Und jetzt gehen Sie auf http://127.0.0.1:8000/redoc.
-* Die alternative Dokumentation spiegelt ebenfalls den neuen Query-Parameter und den Body wider:
+* Die alternative Dokumentation wird ebenfalls den neuen Query-Parameter und Body widerspiegeln:
### Zusammenfassung { #recap }
-Kurz gesagt, Sie deklarieren **einmal** die Typen von Parametern, Body, usw. als Funktionsparameter.
+Zusammengefasst deklarieren Sie **einmal** die Typen von Parametern, Body, usw. als Funktionsparameter.
-Sie tun das mit modernen Standard-Python-Typen.
+Das machen Sie mit modernen Standard-Python-Typen.
-Sie müssen keine neue Syntax, Methoden oder Klassen einer bestimmten Bibliothek, usw. lernen.
+Sie müssen keine neue Syntax, Methoden oder Klassen einer bestimmten Bibliothek usw. lernen.
-Einfach Standard-**Python**.
+Nur Standard-**Python**.
Zum Beispiel für ein `int`:
@@ -357,12 +357,12 @@ item: Item
... und mit dieser einen Deklaration erhalten Sie:
* Editor-Unterstützung, einschließlich:
- * Completion.
+ * Code-Vervollständigung.
* Typprüfungen.
* Validierung von Daten:
- * Automatische und klare Fehler, wenn die Daten ungültig sind.
+ * Automatische und eindeutige Fehler, wenn die Daten ungültig sind.
* Validierung sogar für tief verschachtelte JSON-Objekte.
-* Konvertierung von Eingabedaten: vom Netzwerk zu Python-Daten und -Typen. Lesen aus:
+* Konvertierung von Eingabedaten: Aus dem Netzwerk kommend, zu Python-Daten und -Typen. Lesen von:
* JSON.
* Pfad-Parametern.
* Query-Parametern.
@@ -370,42 +370,42 @@ item: Item
* Headern.
* Formularen.
* Dateien.
-* Konvertierung von Ausgabedaten: Umwandeln von Python-Daten und -Typen in Netzwerkdaten (als JSON):
- * Python-Typen konvertieren (`str`, `int`, `float`, `bool`, `list`, usw.).
+* Konvertierung von Ausgabedaten: Konvertierung von Python-Daten und -Typen zu Netzwerkdaten (als JSON):
+ * Konvertieren von Python-Typen (`str`, `int`, `float`, `bool`, `list`, usw.).
* `datetime`-Objekte.
* `UUID`-Objekte.
* Datenbankmodelle.
* ... und viele mehr.
-* Automatische interaktive API-Dokumentation, inklusive 2 alternativen Benutzeroberflächen:
+* Automatische interaktive API-Dokumentation, einschließlich zwei alternativer Benutzeroberflächen:
* Swagger UI.
* ReDoc.
---
-Zurück zum vorherigen Codebeispiel – **FastAPI** wird:
+Um auf das vorherige Codebeispiel zurückzukommen, **FastAPI** wird:
-* Validieren, dass es einen `item_id` im Pfad für `GET`- und `PUT`-Requests gibt.
-* Validieren, dass der `item_id` vom Typ `int` ist für `GET`- und `PUT`-Requests.
+* Validieren, dass es eine `item_id` im Pfad für `GET`- und `PUT`-Requests gibt.
+* Validieren, ob die `item_id` vom Typ `int` für `GET`- und `PUT`-Requests ist.
* Falls nicht, sieht der Client einen hilfreichen, klaren Fehler.
-* Prüfen, ob es für `GET`-Requests einen optionalen Query-Parameter namens `q` gibt (wie in `http://127.0.0.1:8000/items/foo?q=somequery`).
- * Da der Parameter `q` mit `= None` deklariert ist, ist er optional.
- * Ohne das `None` wäre er erforderlich (so wie der Body im Fall von `PUT`).
-* Für `PUT`-Requests auf `/items/{item_id}` den Body als JSON lesen:
- * Prüfen, dass er ein erforderliches Attribut `name` hat, das ein `str` sein sollte.
- * Prüfen, dass er ein erforderliches Attribut `price` hat, das ein `float` sein muss.
- * Prüfen, dass er ein optionales Attribut `is_offer` hat, das ein `bool` sein sollte, falls vorhanden.
- * All dies funktioniert auch für tief verschachtelte JSON-Objekte.
+* Prüfen, ob es einen optionalen Query-Parameter namens `q` (wie in `http://127.0.0.1:8000/items/foo?q=somequery`) für `GET`-Requests gibt.
+ * Da der `q`-Parameter mit `= None` deklariert ist, ist er optional.
+ * Ohne das `None` wäre er erforderlich (wie der Body im Fall von `PUT`).
+* Bei `PUT`-Requests an `/items/{item_id}` den Body als JSON lesen:
+ * Prüfen, ob er ein erforderliches Attribut `name` hat, das ein `str` sein muss.
+ * Prüfen, ob er ein erforderliches Attribut `price` hat, das ein `float` sein muss.
+ * Prüfen, ob er ein optionales Attribut `is_offer` hat, das ein `bool` sein muss, falls vorhanden.
+ * All dies würde auch für tief verschachtelte JSON-Objekte funktionieren.
* Automatisch von und nach JSON konvertieren.
-* Alles mit OpenAPI dokumentieren, das verwendet werden kann von:
+* Alles mit OpenAPI dokumentieren, welches verwendet werden kann von:
* Interaktiven Dokumentationssystemen.
- * Systemen zur automatischen Client-Code-Generierung, für viele Sprachen.
-* Direkt 2 interaktive Dokumentations-Weboberflächen bereitstellen.
+ * Automatisch Client-Code generierenden Systemen für viele Sprachen.
+* Zwei interaktive Dokumentations-Weboberflächen direkt bereitstellen.
---
-Wir haben hier nur an der Oberfläche gekratzt, aber Sie bekommen bereits eine Vorstellung davon, wie alles funktioniert.
+Wir haben nur an der Oberfläche gekratzt, aber Sie bekommen schon eine Vorstellung davon, wie das Ganze funktioniert.
-Versuchen Sie, die Zeile zu ändern:
+Versuchen Sie, diese Zeile zu ändern:
```Python
return {"item_name": item.name, "item_id": item_id}
@@ -425,19 +425,19 @@ Versuchen Sie, die Zeile zu ändern:
... und sehen Sie, wie Ihr Editor die Attribute automatisch vervollständigt und ihre Typen kennt:
-
+
-Ein vollständigeres Beispiel mit mehr Features finden Sie im das Tutorial – Benutzerhandbuch.
+Für ein vollständigeres Beispiel, mit weiteren Funktionen, siehe das Tutorial – Benutzerhandbuch.
-**Spoilerwarnung**: das Tutorial – Benutzerhandbuch umfasst:
+**Spoiler-Alarm**: Das Tutorial – Benutzerhandbuch enthält:
-* Deklaration von **Parametern** aus verschiedenen Quellen wie: **Header**, **Cookies**, **Formularfelder** und **Dateien**.
-* Wie **Validierungs-Constraints** wie `maximum_length` oder `regex` gesetzt werden.
-* Ein sehr mächtiges und leicht zu nutzendes System für **Dependency Injection**.
-* Security und Authentifizierung, inklusive Support für **OAuth2** mit **JWT-Token** und **HTTP Basic**-Auth.
-* Fortgeschrittene (aber ebenso einfache) Techniken für die Deklaration **tief verschachtelter JSON-Modelle** (dank Pydantic).
+* Deklaration von **Parametern** von anderen verschiedenen Stellen wie: **Header**, **Cookies**, **Formularfelder** und **Dateien**.
+* Wie man **Validierungs-Constraints** wie `maximum_length` oder `regex` setzt.
+* Ein sehr leistungsfähiges und einfach zu bedienendes System für **Dependency Injection**.
+* Sicherheit und Authentifizierung, einschließlich Unterstützung für **OAuth2** mit **JWT-Tokens** und **HTTP Basic** Authentifizierung.
+* Fortgeschrittenere (aber ebenso einfache) Techniken zur Deklaration **tief verschachtelter JSON-Modelle** (dank Pydantic).
* **GraphQL**-Integration mit Strawberry und anderen Bibliotheken.
-* Viele zusätzliche Features (dank Starlette), wie:
+* Viele zusätzliche Features (dank Starlette) wie:
* **WebSockets**
* extrem einfache Tests auf Basis von HTTPX und `pytest`
* **CORS**
@@ -446,9 +446,9 @@ Ein vollständigeres Beispiel mit mehr Features finden Sie im eines der schnellsten verfügbaren Python-Frameworks laufen, nur unterhalb von Starlette und Uvicorn selbst (intern von FastAPI verwendet). (*)
+Unabhängige TechEmpower-Benchmarks zeigen **FastAPI**-Anwendungen, die unter Uvicorn laufen, als eines der schnellsten verfügbaren Python-Frameworks, nur hinter Starlette und Uvicorn selbst (intern von FastAPI verwendet). (*)
-Um mehr darüber zu verstehen, sehen Sie den Abschnitt Benchmarks.
+Um mehr darüber zu erfahren, siehe den Abschnitt Benchmarks.
## Abhängigkeiten { #dependencies }
@@ -464,19 +464,19 @@ Verwendet von Pydantic:
Verwendet von Starlette:
-* httpx – Erforderlich, wenn Sie den `TestClient` verwenden möchten.
-* jinja2 – Erforderlich, wenn Sie die Default-Template-Konfiguration verwenden möchten.
-* python-multipart – Erforderlich, wenn Sie Formular-„parsing“ mit `request.form()` unterstützen möchten.
+* httpx – erforderlich, wenn Sie den `TestClient` verwenden möchten.
+* jinja2 – erforderlich, wenn Sie die Default-Template-Konfiguration verwenden möchten.
+* python-multipart – erforderlich, wenn Sie Formulare mittels `request.form()` „parsen“ möchten.
Verwendet von FastAPI:
* uvicorn – für den Server, der Ihre Anwendung lädt und bereitstellt. Dies umfasst `uvicorn[standard]`, das einige Abhängigkeiten (z. B. `uvloop`) beinhaltet, die für eine Bereitstellung mit hoher Performanz benötigt werden.
-* `fastapi-cli[standard]` – um den Befehl `fastapi` bereitzustellen.
- * Dies umfasst `fastapi-cloud-cli`, womit Sie Ihre FastAPI-Anwendung auf FastAPI Cloud deployen können.
+* `fastapi-cli[standard]` – um den `fastapi`-Befehl bereitzustellen.
+ * Dies beinhaltet `fastapi-cloud-cli`, das es Ihnen ermöglicht, Ihre FastAPI-Anwendung auf FastAPI Cloud bereitzustellen.
### Ohne `standard`-Abhängigkeiten { #without-standard-dependencies }
-Wenn Sie die optionalen `standard`-Abhängigkeiten nicht einschließen möchten, können Sie mit `pip install fastapi` statt `pip install "fastapi[standard]"` installieren.
+Wenn Sie die `standard` optionalen Abhängigkeiten nicht einschließen möchten, können Sie mit `pip install fastapi` statt `pip install "fastapi[standard]"` installieren.
### Ohne `fastapi-cloud-cli` { #without-fastapi-cloud-cli }
@@ -488,13 +488,13 @@ Es gibt einige zusätzliche Abhängigkeiten, die Sie installieren möchten.
Zusätzliche optionale Pydantic-Abhängigkeiten:
-* pydantic-settings – für Settings-Management.
+* pydantic-settings – für die Verwaltung von Einstellungen.
* pydantic-extra-types – für zusätzliche Typen zur Verwendung mit Pydantic.
Zusätzliche optionale FastAPI-Abhängigkeiten:
-* orjson – Erforderlich, wenn Sie `ORJSONResponse` verwenden möchten.
-* ujson – Erforderlich, wenn Sie `UJSONResponse` verwenden möchten.
+* orjson – erforderlich, wenn Sie `ORJSONResponse` verwenden möchten.
+* ujson – erforderlich, wenn Sie `UJSONResponse` verwenden möchten.
## Lizenz { #license }