개발 일상 | 백엔드 김승원의 실무 노트

들어가며REST(Representational State Transfer)는 웹 API 설계의 사실상 표준으로 자리 잡았습니다. 하지만 단순히 JSON을 반환한다고 RESTful API가 되는 것은 아닙니다. 일관성 있고 직관적인 API를 설계하려면 명확한 원칙과 규칙을 따라야 합니다. 이 글에서는 URI 설계, HTTP 메서드 활용, 상태 코드, 페이징, 버전 관리, OpenAPI 문서화까지 실무에서 바로 적용할 수 있는 베스트 프랙티스를 다룹니다.1. URI 설계 원칙URI는 API의 얼굴입니다. 잘 설계된 URI는 문서 없이도 API의 의도를 파악할 수 있게 합니다.기본 규칙명사 사용: 리소스를 나타내므로 동사가 아닌 명사를 사용합니다.복수형 사용: 컬렉션은 복수형으로 표현합니다.소문자와 하이픈: ..

들어가며HTTP(HyperText Transfer Protocol)는 웹의 근간을 이루는 프로토콜입니다. 백엔드 개발자에게 HTTP에 대한 깊은 이해는 성능 최적화, 디버깅, API 설계 등 모든 영역에서 필수적입니다. 이 글에서는 HTTP/1.1부터 HTTP/3까지의 발전 과정과, TCP 핸드셰이크, TLS, Keep-Alive, 상태 코드 등 실무에서 반드시 알아야 할 내용을 정리합니다.1. HTTP 프로토콜의 발전HTTP/1.1 (1997)현재까지도 널리 사용되는 버전입니다. 주요 특징은 다음과 같습니다.Keep-Alive: 기본적으로 연결을 유지하여 매 요청마다 TCP 연결을 새로 맺지 않습니다.파이프라이닝: 이론적으로 여러 요청을 연속 전송할 수 있지만, Head-of-Line Blocking ..