Welche Formate für Anfrage und Antwort unterstützt OpenAPI?

OpenAPI beschränkt die Formate von HTTP-Anfragen und -Antworten nicht, unterstützt jedoch standardmäßig alle Formate, die über MIME-Typen (Content-Type und Accept) beschrieben werden können. Die am häufigsten verwendeten sind:

• application/json — das am weitesten verbreitete Format für REST API
• application/xml — für XML-Daten
• application/x-www-form-urlencoded — für Formular-Daten in Anfragen
• multipart/form-data — zum Hochladen von Dateien

In der OpenAPI-Spezifikation können die unterstützten Formate explizit im Abschnitt content für jeden Endpunkt angegeben werden, zum Beispiel:

requestBody:
  content:
    application/json:
      schema:
        $ref: '#/components/schemas/Example'
responses:
  '200':
    content:
      application/json:
        schema:
          $ref: '#/components/schemas/ExampleResponse'

Auf diese Weise unterstützt OpenAPI flexibel alle Formate, sofern sie korrekt über MIME-Typen und Schemas beschrieben sind.