Update advanced/openapi-callbacks.md

docs/de/docs/advanced/openapi-callbacks.md

@@ -1,4 +1,4 @@
-# OpenAPI-Callbacks
+# OpenAPI Callbacks { #openapi-callbacks }
 
 Sie könnten eine API mit einer *Pfadoperation* erstellen, die einen Request an eine *externe API* auslösen könnte, welche von jemand anderem erstellt wurde (wahrscheinlich derselbe Entwickler, der Ihre API *verwenden* würde).
 
@@ -6,7 +6,7 @@ Der Vorgang, der stattfindet, wenn Ihre API-Anwendung die *externe API* aufruft,
 
 In diesem Fall möchten Sie möglicherweise dokumentieren, wie diese externe API aussehen *sollte*. Welche *Pfadoperation* sie haben sollte, welchen Body sie erwarten sollte, welche Response sie zurückgeben sollte, usw.
 
-## Eine Anwendung mit Callbacks
+## Eine Anwendung mit Callbacks { #an-app-with-callbacks }
 
 Sehen wir uns das alles anhand eines Beispiels an.
 
@@ -16,14 +16,14 @@ Diese Rechnungen haben eine `id`, einen optionalen `title`, einen `customer` (Ku
 
 Der Benutzer Ihrer API (ein externer Entwickler) erstellt mit einem POST-Request eine Rechnung in Ihrer API.
 
-Dann wird Ihre API (beispielsweise):
+Dann wird Ihre API (stellen wir uns vor):
 
 * die Rechnung an einen Kunden des externen Entwicklers senden.
 * das Geld einsammeln.
 * eine Benachrichtigung an den API-Benutzer (den externen Entwickler) zurücksenden.
     * Dies erfolgt durch Senden eines POST-Requests (von *Ihrer API*) an eine *externe API*, die von diesem externen Entwickler bereitgestellt wird (das ist der „Callback“).
 
-## Die normale **FastAPI**-Anwendung
+## Die normale **FastAPI**-Anwendung { #the-normal-fastapi-app }
 
 Sehen wir uns zunächst an, wie die normale API-Anwendung aussehen würde, bevor wir den Callback hinzufügen.
 
@@ -41,7 +41,7 @@ Der Query-Parameter `callback_url` verwendet einen Pydantic-<a href="https://doc
 
 Das einzig Neue ist `callbacks=invoices_callback_router.routes` als Argument für den *Pfadoperation-Dekorator*. Wir werden als Nächstes sehen, was das ist.
 
-## Dokumentation des Callbacks
+## Dokumentation des Callbacks { #documenting-the-callback }
 
 Der tatsächliche Callback-Code hängt stark von Ihrer eigenen API-Anwendung ab.
 
@@ -70,7 +70,7 @@ Wenn Sie den Callback selbst implementieren, können Sie beispielsweise <a href=
 
 ///
 
-## Schreiben des Codes, der den Callback dokumentiert
+## Schreiben des Codes, der den Callback dokumentiert { #write-the-callback-documentation-code }
 
 Dieser Code wird nicht in Ihrer Anwendung ausgeführt, wir benötigen ihn nur, um zu *dokumentieren*, wie diese *externe API* aussehen soll.
 
@@ -86,13 +86,13 @@ Wenn Sie diese Sichtweise (des *externen Entwicklers*) vorübergehend übernehme
 
 ///
 
-### Einen Callback-`APIRouter` erstellen
+### Einen Callback-`APIRouter` erstellen { #create-a-callback-apirouter }
 
 Erstellen Sie zunächst einen neuen `APIRouter`, der einen oder mehrere Callbacks enthält.
 
 {* ../../docs_src/openapi_callbacks/tutorial001.py hl[3,25] *}
 
-### Die Callback-*Pfadoperation* erstellen
+### Die Callback-*Pfadoperation* erstellen { #create-the-callback-path-operation }
 
 Um die Callback-*Pfadoperation* zu erstellen, verwenden Sie denselben `APIRouter`, den Sie oben erstellt haben.
 
@@ -108,7 +108,7 @@ Es gibt zwei Hauptunterschiede zu einer normalen *Pfadoperation*:
 * Es muss kein tatsächlicher Code vorhanden sein, da Ihre Anwendung diesen Code niemals aufruft. Sie wird nur zur Dokumentation der *externen API* verwendet. Die Funktion könnte also einfach `pass` enthalten.
 * Der *Pfad* kann einen <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#key-expression" class="external-link" target="_blank">OpenAPI-3-Ausdruck</a> enthalten (mehr dazu weiter unten), wo er Variablen mit Parametern und Teilen des ursprünglichen Requests verwenden kann, der an *Ihre API* gesendet wurde.
 
-### Der Callback-Pfadausdruck
+### Der Callback-Pfadausdruck { #the-callback-path-expression }
 
 Der Callback-*Pfad* kann einen <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#key-expression" class="external-link" target="_blank">OpenAPI-3-Ausdruck</a> enthalten, welcher Teile des ursprünglichen Requests enthalten kann, der an *Ihre API* gesendet wurde.
 
@@ -163,7 +163,7 @@ Beachten Sie, dass die verwendete Callback-URL die URL enthält, die als Query-P
 
 ///
 
-### Den Callback-Router hinzufügen
+### Den Callback-Router hinzufügen { #add-the-callback-router }
 
 An diesem Punkt haben Sie die benötigte(n) *Callback-Pfadoperation(en)* (diejenige(n), die der *externe Entwickler* in der *externen API* implementieren sollte) im Callback-Router, den Sie oben erstellt haben.
 
@@ -177,9 +177,9 @@ Beachten Sie, dass Sie nicht den Router selbst (`invoices_callback_router`) an `
 
 ///
 
-### Es in der Dokumentation ansehen
+### Es in der Dokumentation ansehen { #check-the-docs }
 
-Jetzt können Sie Ihre Anwendung mit Uvicorn starten und auf <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> gehen.
+Jetzt können Sie Ihre Anwendung starten und zu <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> gehen.
 
 Sie sehen Ihre Dokumentation, einschließlich eines Abschnitts „Callbacks“ für Ihre *Pfadoperation*, der zeigt, wie die *externe API* aussehen sollte: