Skip to content

Conversation

@sickbirdd
Copy link
Collaborator

@sickbirdd sickbirdd commented Nov 20, 2023

Resolves #84

진행 내용

  • NestJS swagger 설정
  • API의 request body 구조 및 예시 설명
  • API의 Response Entity 설명

localhost:3000/docs로 접속하면 API 문서를 확인할 수 있습니다.
NestJS의 swagger를 활용하여 API 문서를 작성했습니다. Annotation을 활용해서 간단하게 문서화 작업을 할 수 있었습니다. 이후에 작업할 때, 관련 문법을 알아두면 좋을 것 같아서 학습 링크도 남깁니다.

https://docs.nestjs.com/openapi/introduction
https://docs.nestjs.com/openapi/types-and-parameters
https://docs.nestjs.com/openapi/operations

스크린샷 (선택)

스크린샷1

스크린샷2

@sickbirdd sickbirdd added feature 새로운 기능 backend 백엔드 관련 docs 문서 관련 labels Nov 20, 2023
@sickbirdd sickbirdd added this to the 3주차 milestone Nov 20, 2023
@sickbirdd sickbirdd self-assigned this Nov 20, 2023
Copy link
Collaborator

@Muungi Muungi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

고생하셨습니다! swagger를 연동하여 API 문서화가 자동화 되는 것이 매우 편리해 보이네요!

@sickbirdd sickbirdd linked an issue Nov 20, 2023 that may be closed by this pull request
3 tasks
@sickbirdd sickbirdd requested a review from Muungi November 20, 2023 10:01
@sickbirdd sickbirdd requested a review from Muungi November 20, 2023 10:41
@Muungi Muungi merged commit 8ef4735 into dev/be Nov 20, 2023
@sickbirdd sickbirdd deleted the feat/be/swagger-docs branch December 14, 2023 16:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backend 백엔드 관련 docs 문서 관련 feature 새로운 기능

Projects

No open projects

Development

Successfully merging this pull request may close these issues.

[서버] API 문서화

3 participants