🌿 중급 백엔드
REST API가 뭔가요?
쉽게 이해하기
REST API는 레스토랑 메뉴판과 같아요. 메뉴판에는 '피자 주문', '음료 주문', '계산하기' 같은 명확한 항목이 있고, 각 항목마다 정해진 방식으로 요청하면 원하는 결과를 받을 수 있죠. REST API도 마찬가지로 '/users', '/products', '/orders' 같은 명확한 주소와 방식을 정해두고, 그 규칙대로 데이터를 주고받습니다.
핵심 정리
웹에서 데이터를 주고받는 가장 널리 쓰이는 규칙입니다.
자세히 알아보기
REST(Representational State Transfer) API는 웹에서 클라이언트와 서버가 데이터를 주고받을 때 따르는 설계 규칙입니다. '표현 상태 전송'이라는 의미지만, 실무에서는 그냥 '깔끔하고 일관된 방식으로 데이터를 주고받는 API'라고 이해하시면 됩니다.
REST API의 핵심은 URL로 자원(Resource)을 표현하고, HTTP 메서드(GET, POST, PUT, DELETE)로 행동을 나타낸다는 것입니다. 예를 들어 '/api/users/123'이라는 주소는 '123번 사용자 정보'를 의미하고, GET 요청으로 조회, PUT 요청으로 수정, DELETE 요청으로 삭제를 합니다. 동사보다는 명사로 URL을 만들고, 계층 구조를 명확히 하는 게 REST의 특징이에요.
실무에서 REST API는 모바일 앱과 서버, 웹사이트와 서버, 서버와 서버 간 통신에 가장 많이 쓰입니다. 예를 들어 인스타그램 앱에서 게시물을 불러올 때 'GET /api/posts', 좋아요를 누를 때 'POST /api/posts/456/like' 같은 REST API를 호출하는 거죠. REST 방식을 따르면 개발자들이 직관적으로 이해하고 사용할 수 있어서, 전 세계적으로 가장 널리 쓰이는 API 설계 방식이 되었습니다.
REST API를 잘 만들면 프론트엔드 개발자와 백엔드 개발자가 효율적으로 협업할 수 있고, 나중에 API 문서를 보고 다른 개발자가 쉽게 이해할 수 있습니다. 쇼핑몰을 만든다면 '/api/products'로 상품 목록, '/api/cart'로 장바구니, '/api/orders'로 주문을 관리하는 식으로, 일관된 구조로 전체 시스템을 설계할 수 있어요.