REST API 설계 모범 사례 2026

실무에서 바로 적용할 수 있는 REST API 설계 원칙과 패턴.

좋은 API URL의 원칙: 명사 사용(/users, /orders), 복수형(/users, not /user), 계층 관계 표현(/users/123/orders), 동사 대신 HTTP 메서드(GET/POST/PUT/DELETE).

일관된 에러 응답 형식: HTTP 상태 코드(400, 401, 404, 500 등) + 에러 코드(앱 고유) + 사용자 메시지 + 상세 정보(개발 환경에서만).

대량 데이터 처리: 커서 기반 페이지네이션(offset보다 안정적), 필터(?status=active), 정렬(?sort=-created_at), 필드 선택(?fields=id,name).