이 질문 뒤에 면접관이 확인하려는 것은 따로 있습니다.
팀 프로젝트에서 Swagger로 API 문서를 처음 자동 생성했습니다. 이전에는 Notion에 API 명세를 수동으로 작성했는데, 코드와 문서가 따로 놀아서 프런트엔드에서 잘못된 파라미터로 요청을 보내는 경우가 생겼습니다. @ApiProperty 데코레이터로 코드에 명세를 붙이니 배포 후 자동으로 문서가 갱신되는 구조가 됐습니다. 문서가 살아있으니 프런트엔드와 명세를 기준으로 소통하는 방식이 생겼고, 인터페이스 불일치 논쟁이 줄었습니다. Swagger UI에서 API를 직접 테스트할 수 있는 기능도 실제로 개발 속도를 높여줬습니다. 버전 변경이 생길 때마다 문서를 업데이트하는 대신 코드를 고치면 문서가 따라오는 구조가, 팀 신뢰의 기반이 됐습니다.
API 문서는 팀 소통의 공용어이고, 자동 생성 도구가 그 공용어를 항상 최신 상태로 유지해준다고 생각합니다.
Swagger 도입 이후 API 개발 방식 자체를 바꾸는 경험을 했습니다. 이전에는 백엔드가 API를 다 만든 뒤에 프론트엔드가 연동을 시작하는 순서로 진행했는데, API 명세를 먼저 정의하는 방식을 시도했습니다. OAS 파일로 API 계약을 먼저 작성하고, 백엔드와 프론트엔드가 같은 명세를 기준으로 동시에 개발하는 구조를 만들었습니다. 프론트엔드는 Mock 서버로 개발을 진행하고, 백엔드가 완성되면 연동하는 방식이었습니다. 덕분에 백엔드 개발 완료를 기다리는 블로킹 시간이 크게 줄었습니다. API 문서화의 가치가 산출물이 아니라 협업 구조를 바꾸는 결에 있다는 것을 이 경험에서 배웠습니다.
API를 변경하면서 기존 사용자에게 영향을 주는 변경(Breaking Change)을 명확히 공지하지 않아 문제가 생긴 경험이 있습니다. 응답 필드 이름을 바꿨는데, 이전 필드 이름에 의존하던 클라이언트 코드가 갑자기 동작을 멈추는 결이 됐습니다. 이후에는 API 변경 전에 어떤 변경이 기존 사용자에게 영향을 주는지 먼저 분류하는 과정을 추가했습니다. Breaking Change는 메이저 버전을 올리고 이전 버전과 일정 기간 동시 지원하는 방식을 채택했습니다.
API를 변경할 때는 내 코드가 아니라 그것에 의존하는 코드를 먼저 생각해야 하는 결이 있다는 것을 이 경험에서 배웠습니다. 문서화는 변경된 것을 기록하는 것뿐 아니라 무엇이 바뀌면 연동이 깨지는지를 알리는 결이기도 했습니다.
답변에서 흔히 빠지는 것들 — 빠져 있으면 꼬리질문이 깊어집니다.
이 질문에 이어 에코마케팅 백엔드 면접관이 던질 가능성이 높은 후속 질문.
이 페이지의 질문·답변·꼬리질문은 유사 직군 채용 시장의 공개된 면접 후기·커뮤니티 게시물을 분석해 구성한 학습 자료입니다. 특정 회사가 실제로 이 질문을 출제했다는 것을 보장하지 않으며, 모든 예시는 우문현답이 직접 작성한 창작물입니다. 해당 회사의 공식 입장과는 무관합니다. 회사 측의 정정 요청이 있을 경우 24시간 이내에 응답·수정합니다.