API 설계 면접 퀴즈

REST API 설계 원칙

핵심 원칙

1. 리소스 중심 URL: /users/123 (O) vs /getUser?id=123 (X)
2. HTTP 메서드 활용: GET=조회, POST=생성, PUT=수정, DELETE=삭제
3. 적절한 상태 코드: 200, 201, 400, 401, 404, 500

URL 설계 규칙

실무 포인트

• 버전 관리: /api/v1/users (URL 방식이 가장 보편적)
• 페이지네이션: ?page=1&limit=20 또는 커서 기반
• 에러 응답 표준화: { error: string, code: string }

인증과 인가

차이점

API 인증 방식

실무 포인트

• 최소 권한 원칙: 필요한 권한만 부여
• Access Token + Refresh Token 패턴 권장
• 면접 빈출: "OAuth 2.0 흐름을 설명해주세요"

HTTP 상태 코드와 에러 응답 설계

코드 선택 기준

에러 본문 표준화

{
  "type": "/errors/insufficient-balance",
  "title": "잔액이 부족합니다",
  "status": 409,
  "detail": "요청 12000원, 잔액 3500원"
}

기계가 분기할 값(type)과 사람이 읽을 문장(title, detail)을 분리한다. 필드 검증 오류는 어느 필드가 왜 틀렸는지 배열로 함께 준다.

실무 포인트

• 200 고정 + 본문 에러코드 방식은 프록시와 모니터링이 전부 성공으로 집계해 장애 감지를 늦춘다
• 5xx는 재시도 대상, 4xx는 재시도 무의미하다. 상태 코드가 클라이언트 재시도 정책의 입력값이다
• 권한 없는 리소스의 존재 여부를 숨기려면 403 대신 404를 주는 선택도 있다
• 내부 예외 메시지와 스택트레이스를 응답에 넣지 않는다