본문 바로가기

Swagger

MIME 타입

이메일 전송 시 사용하던 타입이지만 API 요청에 대한 응답 타입을 지정할 때도 쓰인다.

 

전역 MIME 타입은 API docs의 루트 레벨에 정의될 수 있고, 모든 API operation 의해 상속될 수 있다.

 

consumes는 POST, PUT, PATCH처럼 요청 body가 있는 operation에 영향을 준다. GET처럼 body가 없는 작업은 무시된다. operation 레벨에서 consumes, produces를 사용하면 전역 정의가 오버라이드된다.

paths:
  /logo:
    get:
      summary: Returns the logo image
      produces:
        - image/png
        - image/gif
        - image/jpeg
      responses:
        200:
          description: OK
          schema:
            type: file

 

RFC 6838을 준수해야한다. MIME 타입 표준

application/json
application/xml
application/x-www-form-urlencoded
multipart/form-data
text/plain; charset=utf-8
text/html
application/pdf
image/png