API 스펙 합의 과정을 주도한 중재 경험 결
인턴 때 내부 데이터 파이프라인 팀과 프론트엔드 팀 사이에서 API 인터페이스를 설계하는 역할을 맡았습니다. 처음에는 양쪽 팀이 서로 "상대가 맞춰야 한다"는 입장이었고, 저는 그 사이에서 어느 쪽 요구가 합리적인지 판단하기가 어려웠습니다.
결국 공통 스펙 문서를 먼저 만들자고 제안했습니다. 각 팀이 "꼭 필요한 필드"와 "있으면 좋은 필드"를 나눠서 적게 했더니, 실제로 겹치는 부분이 생각보다 많았습니다. Swagger로 명세를 정리한 뒤 두 팀이 함께 리뷰하는 자리를 2회 가졌고, 그제야 논쟁이 줄었습니다.
가장 어려웠던 건 한 팀이 인터페이스를 중간에 바꾸고 싶어할 때였습니다. 변경 요청은 버전 번호를 올리고 구버전을 일정 기간 유지하는 방식으로 합의했습니다. 이게 플랫폼을 개방적으로 유지하면서도 기존 사용자를 보호하는 방법이라는 걸 그때 처음 배웠습니다.