🌿 중급 백엔드
RESTful API란?
쉽게 이해하기
도서관을 떠올려보세요. 책을 대출하려면 대출 신청서를, 반납하려면 반납 신청서를 작성하잖아요. RESTful API는 이처럼 각 작업마다 정해진 규칙과 양식이 있는 거예요. 'GET /books'는 책 목록 조회, 'POST /books'는 새 책 등록처럼 URL만 봐도 무슨 작업인지 알 수 있죠.
핵심 정리
REST 원칙을 따르는 API 설계 방식으로, 체계적이고 직관적인 API를 만들 수 있어요.
자세히 알아보기
RESTful API는 REST(Representational State Transfer) 아키텍처 스타일을 따르는 API 설계 방식입니다. 단순히 API를 만드는 게 아니라, 일관된 규칙을 따라서 누구나 이해하기 쉽게 만드는 거예요.
핵심 원칙은 크게 네 가지입니다. 첫째, 자원은 URL로 표현합니다(/users, /posts). 둘째, HTTP 메서드로 행위를 나타냅니다(GET은 조회, POST는 생성). 셋째, 상태를 저장하지 않습니다(Stateless). 넷째, 자원의 표현은 JSON이나 XML로 전달합니다.
실무에서는 이 규칙들을 지키면 협업이 훨씬 수월해집니다. 예를 들어 'GET /api/users/123'이라는 엔드포인트를 보면, 개발자가 아니어도 '사용자 123번의 정보를 가져오는구나'라고 직관적으로 이해할 수 있어요. 반대로 규칙을 무시하고 'GET /deleteUser?id=123'처럼 만들면 혼란스럽죠.
RESTful 설계가 중요한 이유는 유지보수와 확장성 때문입니다. 새로운 개발자가 프로젝트에 투입되어도 API 문서만 보면 빠르게 이해할 수 있고, 나중에 기능을 추가할 때도 일관된 패턴을 따라갈 수 있습니다. 실제로 대부분의 오픈 API(구글, 트위터, 깃허브 등)는 RESTful 방식을 따르고 있어요.