10 posts in total

Swagger

Posts tagged

애저 펑션 Swagger UI 소개

by Justin Yoo · 5 min read

알림: 이 포스트는 순수한 개인의 견해이며, 제가 속해있는 직장의 의견 혹은 입장을 대변하지 않습니다. ASP.NET Core 애플리케이션에서는 Swashbuckle이라는 엄청난 라이브러리가 있어서 이를 이용하면 정말로 손쉽게 Swagger 문서 및 UI를 사용할 수 있다. 하지만 애저 펑션에서는 아직까지 이런 기능을 제공하지 못하고 있는 상황이다. 애저 펑션 1.x 에서는 프리뷰 형태로 Swagger 문서를 제한적이나마 제공해 왔다. 이와 관련한 포스트도 예전에 썼던 적이 있었는데, 그 포스 ...

애저 펑션에서 Swagger 정의 문서 출력하기

by Justin Yoo · 5 min read

알림: 이 포스트는 순수한 개인의 견해이며, 제가 속해있는 직장의 의견 혹은 입장을 대변하지 않습니다. 애저 펑션 1.x 에서는 Swagger 정의 문서를 렌더링할 수 있는 기능이 프리뷰로 제공된다. 이와 관련한 블로그 포스팅도 예전에 했더랬는데, 아쉽게도 현재 2.x 버전의 애저 펑션에서는 이 기능을 제공하지 않는다. 따라서 수동으로 Swagger 문서를 렌더링하는 기능을 구현할 수 밖에 없는데, 이 포스트에서는 이를 어떻게 구현하는지 알아보도록 한다. 설계 우선 vs 구현 우선 앞서 언급했 ...

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3

by Justin Yoo · 4 min read

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3 지난 포스트에 이어 이 포스트에서는 Swashbuckle 라이브러리를 이용해서 Swagger 문서가 XML 문서를 다룰 수 있게 도와주는 확장 기능에 대해 알아본다. 이 포스트에 사용된 코드 샘플은 이곳에서 확인할 수 있다. 참고사항 이 포스트에 사용한 애플리케이션은 아래 스펙으로 만들어졌다: ASP.NET Web ...

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2

by Justin Yoo · 3 min read

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3 지난 포스트에 이어 이 포스트에서도 Swashbuckle 라이브러리를 이용해서 Swagger 문서를 작성할 경우 필요한 확장 기능에 대해 알아본다. 이 포스트에 사용된 코드 샘플은 이곳에서 확인할 수 있다. 참고사항 이 포스트에 사용한 애플리케이션은 아래 스펙으로 만들어졌다: ASP.NET Web API Swagg ...

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1

by Justin Yoo · 3 min read

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3 ASP.NET Web API 애플리케이션을 개발하면 빠지지 않는 것이 바로 Swagger 문서 생성이다. Swashbuckle을 사용하면 이 작업을 굉장히 손쉽게 할 수 있다. 하지만, 이 라이브러리는 Swagger 스펙을 100% 구현하지 않았다. 필수적으로 쓰여야 하는 부분들을 제외하고는 크게 중요치 않은 부분은 확 ...

Azure Functions에 Swagger 통합하기

by Justin Yoo · 6 min read

얼마전 Azure Functions(애저 펑션)에 Swagger로 알려진 OpenAPI 지원 기능이 추가됐다. 애저 펑션을 API로 사용할 경우 굉장히 유용한 기능인데, 이 포스트에서는 어떻게 Swagger를 연동시킬 수 있는지 간단하게 알아보기로 한다. 이 포스트에 쓰인 샘플 코드는 이곳에서 확인할 수 있다. 샘플 애저 펑션 인스턴스 우선 애저 펑션 인스턴스를 생성해서 간단한 펑션을 두 개 만들어 보도록 한다. 하나는 CreateProduct이고, 다른 하나는 GetProduct이다. Po ...