Sobes.tech
Middle

Quais formatos de solicitação e resposta de tele suporta o OpenAPI?

sobes.tech IA

Resposta da IA

O OpenAPI não limita os formatos de pedidos e respostas HTTP, mas suporta de forma padrão quaisquer formatos que possam ser descritos através de tipos MIME (Content-Type e Accept). Os mais utilizados são:

  • application/json — o formato mais comum para REST API
  • application/xml — para dados XML
  • application/x-www-form-urlencoded — para dados de formulários em pedidos
  • multipart/form-data — para carregamento de ficheiros

Na especificação OpenAPI, pode indicar explicitamente os formatos suportados na secção content para cada endpoint, por exemplo:

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

Assim, o OpenAPI suporta de forma flexível quaisquer formatos, desde que estejam corretamente descritos através de tipos MIME e esquemas de dados.