시스템 디자인
API 설계 면접: 요구사항을 구조로 답하는 법
API 설계 면접에서 요구사항, 데이터 모델, 오류 처리, 확장성을 순서대로 설명하는 실전 답변 프레임입니다.
첫 30초 답변
“먼저 사용자의 핵심 동작과 성공 기준을 확인한 뒤, API 계약·데이터·실패 처리 순서로 설계하겠습니다.”라고 시작하면 구현보다 문제 해결을 우선하는 인상을 줍니다.
자주 묻는 질문과 답변의 뼈대
어떤 API를 먼저 정의하나요?
가장 빈번하고 가치가 큰 사용자 흐름 하나를 고릅니다. 리소스, 요청·응답 예시, 인증 주체, 성공·실패 상태 코드를 말한 뒤 나머지 API를 확장합니다.
동시 요청으로 중복 생성되면요?
클라이언트 idempotency key와 서버의 유니크 제약을 함께 둡니다. 재시도는 같은 결과를 반환하고, 충돌 시 어떤 응답을 줄지 계약에 명시합니다.
나중에 기능이 늘어나면요?
버전은 꼭 필요한 호환성 파괴 때만 사용하고, 선택 필드 추가처럼 호환 가능한 변경을 우선합니다. 관측 지표와 사용량을 확인한 뒤 제거 일정을 잡습니다.
면접 전 체크리스트
- 사용자·트래픽·지연 시간·데이터 보존 기간을 먼저 물었다
- 대표 요청과 응답을 한 쌍 이상 제시했다
- 인증·권한·입력 검증·오류 응답을 언급했다
- 재시도·중복·부분 실패의 동작을 설명했다
관련 언어 학습으로 복습하기
연습 방법
질문 하나를 골라 2분 안에 말로 답한 뒤, 빠진 가정·트레이드오프·검증 방법을 메모하세요. 다음 날에는 예시를 바꿔 같은 구조로 다시 답해 보세요.