RESTful API를 설명해 주세요

resourcehttp-methodstatus-code

RESTful API를 설명해 주세요

예상 시간: 6분

30초 답변

RESTful API는 서버 기능을 action 이름 중심으로 나열하기보다 resource 중심으로 설계하는 방식입니다.

예를 들어 user 목록은 /users, 특정 user는 /users/{id}처럼 표현하고, 조회는 GET, 생성은 POST, 수정은 PUT이나 PATCH, 삭제는 DELETE를 사용합니다.

응답도 200, 201, 400, 401, 404 같은 HTTP status code로 의미를 전달합니다. 중요한 점은 URL, method, status code가 일관되어 API를 예측 가능하게 만드는 것입니다.

꼬리질문

조금 더 깊게 물어본다면

답변 뒤에 이어질 수 있는 질문들을 하나씩 열어볼 수 있어요.

PUT과 PATCH는 어떻게 다른가요?

부가 설명

GET /users/1
POST /users
PATCH /users/1
DELETE /users/1

/getUser, /createUser처럼 동사를 URL에 넣기보다, resource는 URL로 두고 행위는 method로 표현합니다.

REST는 엄밀한 architectural style이고, 실무에서 말하는 RESTful API는 그 원칙을 현실적으로 적용한 HTTP API를 뜻하는 경우가 많습니다. 완벽한 REST를 지키는지보다, resource 모델과 HTTP semantics를 일관되게 쓰는지가 더 중요할 때가 많습니다.

한 줄 정리

RESTful API는 URI로 resource를 표현하고 HTTP method와 status code로 행위와 결과를 일관되게 전달하는 설계 방식입니다.