Beschreibst du direkt in der OpenAPI-Spezifikation?

Ja, die OpenAPI-Spezifikation ermöglicht es, APIs direkt im YAML- oder JSON-Format zu beschreiben, wobei Pfade, Methoden, Parameter, Datenschemas und Antworten detailliert angegeben werden. Dies ist eine praktische Methode, um APIs zu dokumentieren und zu standardisieren sowie Client-Code und Tests zu generieren. Zum Beispiel kann man einen Endpunkt so beschreiben:

paths:
  /users:
    get:
      summary: Liste der Benutzer abrufen
      responses:
        '200':
          description: Erfolgreiche Antwort
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'