Sobes.tech
Middle

Jakie formaty zapytań i odpowiedzi tele obsługuje OpenAPI?

sobes.tech AI

Odpowiedź od AI

OpenAPI nie ogranicza formatów żądań i odpowiedzi HTTP, ale domyślnie obsługuje dowolne formaty, które można opisać za pomocą typów MIME (Content-Type i Accept). Najczęściej używane to:

  • application/json — najpowszechniejszy format dla REST API
  • application/xml — dla danych XML
  • application/x-www-form-urlencoded — dla danych formularzy w żądaniach
  • multipart/form-data — do przesyłania plików

W specyfikacji OpenAPI można wyraźnie wskazać obsługiwane formaty w sekcji content dla każdego punktu końcowego, na przykład:

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

W ten sposób OpenAPI elastycznie obsługuje dowolne formaty, jeśli są one poprawnie opisane za pomocą typów MIME i schematów danych.