DATABASE · CHAPTER 04
중급 · 48분백엔드 API 설계
경계를 명확히 하는 서버 코드
자원 중심 URL, 검증, 오류 응답, 페이지네이션을 설계한다.
CONCEPTS
개념을 문장으로 설명하기
자원 중심 URL
URL은 보통 동작이 아니라 관리 대상 명사를 표현하고, 동작의 의미는 HTTP 메서드로 전달합니다.
예시
/courses/3/enrollments는 수강 관계 자원을 표현합니다.
CHECK동사 URL이 항상 틀린 것은 아니지만 의미를 먼저 정한다.
요청 검증
API 경계에서 타입·범위·필수값·권한을 확인하는 처리입니다.
예시
page는 1 이상 정수인지, limit은 최대값을 넘지 않는지 검사합니다.
CHECK오류 메시지는 사용자에게 안전하고 구체적이어야 한다.
페이지네이션
많은 목록을 한 번에 보내지 않고 일정 단위로 나눠 조회하는 방식입니다.
예시
GET /posts?page=2&limit=20처럼 범위를 전달합니다.
CHECK정렬 기준이 안정적이어야 중복·누락을 줄인다.
GUIDED PRACTICE
과제 목록 API
학생의 과제를 날짜순으로 20개씩 보여 줍니다.
- GET /assignments?page=1&limit=20처럼 조회 자원과 옵션을 분리합니다.
- 서버에서 page·limit을 검증하고 허용 상한을 둡니다.
- createdAt과 id 같은 안정적인 정렬 기준을 정해 목록을 반환합니다.
결론
작은 응답 단위, 명확한 정렬·오류 규칙이 UI와 서버 모두를 단순하게 합니다.
ACTIVE RECALL · 4 STEPS
가리고, 말하고, 확인하기
읽기만 하지 말고 답을 떠올린 뒤 펼쳐 보세요.
01 · 정의 회상
“자원 중심 URL”을(를) 보지 않고 한 문장으로 정의해 보세요.
02 · 비교 설명
“요청 검증”이(가) 필요한 상황을 예시와 함께 설명해 보세요.
03 · 핵심 점검
정렬 기준이 안정적이어야 중복·누락을 줄인다.
04 · 풀이 재현
“과제 목록 API”의 결론을 보기 전에 풀이 순서를 3단계로 다시 적어 보세요.
WORKBOOK · STEP BY STEP
개념 확인 문제
정답을 고르고 해설로 사고 과정을 확인하세요.
01
수강 3번의 정보를 조회하는 URL로 가장 자연스러운 것은?
02
목록이 매우 클 때 한 번에 모두 보내지 않는 이유로 적절한 것은?
03
권한 검증을 반드시 수행해야 하는 위치는?
SPEAK IT OUT
면접 1분 답변 연습
좋은 REST API를 설계할 때 URL·메서드·상태 코드·검증을 어떻게 함께 고려하는지 설명해 보세요.
답변할 때는 정의 → 이유 → 짧은 예시 순서로 말해 보세요.공식·표준 자료로 더 읽기
MDN · HTTP Reference원문 열기 ↗HTTP 메서드·헤더·상태 코드의 참고 문서입니다.