두숟갈 스터디 11회

Two Scoops of Django 16장인 REST API 구현하기를 함께 살펴봤다. 새로 시작하는 프로젝트에서 API 개발을 맡게 된 문수님이 책 내용을 정리해 발표했고, REST API가 다양한 환경과 용도에 맞는 데이터를 제공하는 설계 방식이라는 점을 다시 짚었다.

REST API 아키텍처를 잘 만들려면 단순히 django-rest-framework(DRF) 로 빠르게 구현하는 것만으로는 부족하다. 프로젝트 코드는 간결하게 정리하고, 앱 코드는 앱 내부에 두며, 비즈니스 로직은 API 뷰에서 분리하고, API URL을 모아두고, 버저닝까지 고려해야 한다는 조언이 핵심이었다.

또한 웹 애플리케이션을 독립된 컴포넌트로 나누는 서비스 지향 아키텍처 관점도 다뤘다. 서로 다른 서버가 REST API 로 통신하면 여러 엔지니어가 충돌 없이 분리된 컴포넌트를 병렬로 개발할 수 있고, 규모가 커질수록 이런 구조의 장점이 커진다.

프레임워크 관점에서는 django-rest-framework 가 이미 현실적인 표준으로 자리 잡았다는 평가가 나왔다. 장고 프로젝트에서 널리 쓰이고 있으며, 클래스 기반 뷰와 함수 기반 뷰를 모두 지원해 실무 적용성이 높다는 점도 함께 언급됐다.

심화 시간에는 예전 회사에서 서버를 역할별로 나누고 REST API 로 연결했던 경험담이 공유됐다. 당시에는 지금처럼 프레임워크가 안정적이지 않아 더 불편했지만, 그만큼 현재의 도구들이 얼마나 편리한지도 체감할 수 있었다.

마지막으로 Resource 관점에서 컬렉션, 도큐먼트, 콘트롤러 리소스와 URI, HTTP를 이용한 인터랙션 설계도 살펴봤다. 예시로 GitHub Pull Requests API 를 참고하며 API 이용 개념을 구체화했고, 발표자는 이 과정을 통해 REST API의 필요성과 학습 동기를 더 분명히 느꼈다고 정리했다.