REST API란?Mastering Core REST API Questions
📅
🚀
들어가기 전에 🔗
REST API는 클라이언트와 서버가 서로 대화하는 가장 보편적인 방식 중 하나이기 때문에, 프론트엔드와 백엔드 직무를 가리지 않고 거의 모든 면접에서 질문이 나온다고 해도 과언이 아닙니다.
오늘은 단순히 개념을 암기하는 것을 넘어, "왜 이렇게 만들어졌을까?"를 생각하며 면접관의 어떤 질문에도 막힘없이 대답할 수 있도록 쉽고 명확하게 정리해 보겠습니다.
🚀
"REST API가 무엇인가요?" 🔗
이것은 가장 기본적이면서도 핵심을 찌르는 질문입니다.
당황하지 않고 이 질문에 잘 대답하려면, 단어 하나하나를 뜯어서 이해하는 것이 좋습니다.
REST는
RE
presentational S
tate T
ransfer의 약자입니다.
어렵게 들리지만, 식당에서의 주문 과정에 비유하면 아주 쉽게 이해할 수 있습니다.- 자원(Resource) → 음식우리가 얻고 싶은 데이터입니다. 예를 들어 '회원 정보', '게시글 목록' 등이 자원입니다. 식당의 '파스타', '스테이크' 같은 메뉴에 해당합니다.
- 표현(Representation) → 나온 음식의 형태자원을 어떤 형태로 보여줄 것인가를 의미합니다. '회원 정보'라는 자원은 보통 JSON 형태로 표현됩니다. '파스타'라는 메뉴가 접시에 담겨 나오는 것과 같습니다.
- 상태 전달(State Transfer) → 주문과 서빙서버에 있는 자원의 상태를 클라이언트에게 전달하는 것을 의미합니다. 클라이언트가 "1번 회원의 정보를 JSON 형태로 주세요" 라고 요청하면, 서버는 그 요청에 맞는 데이터를 만들어서 전달해 줍니다. 마치 손님이 '파스타 하나 주세요' 라고 주문하면, 주방에서 파스타를 만들어 손님에게 서빙하는 것과 같습니다.
따라서 면접에서 이 질문을 받는다면 이렇게 대답할 수 있습니다.
REST는 웹 상에서 자원을 정의하고, 그 자원의 상태를 주고받는 규칙들의 모음, 즉 하나의 아키텍처 스타일입니다. 자원을 URL로 표현하고, 해당 자원에 대한 행위는 HTTP 메서드로 정의하여, 클라이언트와 서버가 명확하게 소통할 수 있도록 돕습니다.
REST API
🚀
"주요 HTTP 메서드와 그 역할에 대해 설명해 주세요." 🔗
REST는 자원에 대한 행위를 HTTP 메서드로 명확하게 표현합니다.
이것은 REST의 가장 중요한 특징 중 하나이므로, 각 메서드의 역할을 정확히 알아야 합니다.
- GET (조회)서버의 자원을 가져올 때 사용합니다. 데이터를 변경하지 않으며, 몇 번을 호출하더라도 항상 같은 결과를 돌려주는멱등성을 가집니다.
- POST (생성)서버에 새로운 자원을 생성할 때 사용합니다. 예를 들어, 새 회원을 가입시키거나 새 게시글을 작성할 때 사용됩니다. 호출할 때마다 새로운 자원이 생성될 수 있으므로 멱등하지 않습니다.
- PUT (전체 수정)이미 존재하는 자원의 내용 전체를 새로운 내용으로 덮어쓸 때 사용합니다. 만약 자원이 존재하지 않으면 새로 생성하기도 합니다. 몇 번을 호출하더라도 결과는 항상 같으므로 멱등합니다.
- PATCH (부분 수정)자원의 일부만 수정하고 싶을 때 사용합니다. 예를 들어, 회원의 비밀번호만 변경하는 경우입니다.
PUT보다 효율적일 수 있습니다. - DELETE (삭제)특정 자원을 서버에서 삭제할 때 사용합니다. 멱등성을 가집니다. (이미 삭제된 것을 또 삭제 요청해도 결과는 '삭제된 상태'로 동일하기 때문입니다.)
👍
멱등성이라는 단어를 정확히 이해하고 설명할 수 있다면 좋은 인상을 줄 수 있습니다.멱등성이란, 동일한 요청을 한 번 보내든 여러 번 연속으로 보내든 결과가 똑같은 성질을 의미합니다.
🚀
"RESTful API란 무엇인가요?" 🔗
'RESTful 하다'는 것은 'REST의 규칙을 아주 잘 따라서 설계되었다'는 의미입니다.
RESTful API의 핵심 설계 원칙 몇 가지는 다음과 같습니다.
- URL은 자원을 나타내야 합니다.
- 나쁜 예:
/getUserInfo/1 - 좋은 예:
/users/1
- 나쁜 예:
- 행위는 HTTP 메서드로 나타내야 합니다.
- 나쁜 예:
POST /deleteUser/1 - 좋은 예:
DELETE /users/1
- 나쁜 예:
- URL에는 동사보다 명사를, 소문자를 사용합니다.
- 자원을 표현하는 것이므로
user,post같은 명사를 사용하고, 대문자보다는 소문자를 사용하는 것이 일반적입니다.
- 자원을 표현하는 것이므로
🚀
"자주 사용하는 HTTP 상태 코드에 대해 아는 대로 말해보세요." 🔗
상태 코드는 서버가 클라이언트의 요청에 대해 어떤 결과를 보냈는지 알려주는 세 자리 숫자 신호입니다.
모두 외울 필요는 없지만, 각 그룹의 의미와 자주 쓰이는 코드 몇 개는 반드시 알아야 합니다.
- 2xx (성공)요청이 성공적으로 처리되었음을 의미합니다.
200 OK요청이 성공했고, 보통 응답 본문에 데이터가 함께 옵니다. (GET 성공)201 Created요청이 성공하여 새로운 자원이 생성되었습니다. (POST 성공)204 No Content요청은 성공했지만, 응답으로 보낼 데이터는 없습니다. (DELETE 성공)
- 4xx (클라이언트 오류)요청 자체에 문제가 있을 때 발생합니다.
400 Bad Request요청의 형식이 잘못되었을 때 발생합니다.401 Unauthorized인증(로그인 등)이 필요한 요청인데, 인증되지 않았을 때 발생합니다.403 Forbidden인증은 되었지만, 해당 자원에 접근할 권한이 없을 때 발생합니다.404 Not Found요청한 자원이 서버에 존재하지 않을 때 발생합니다.
- 5xx (서버 오류)서버 내부에서 문제가 발생하여 요청을 처리할 수 없을 때 발생합니다.
500 Internal Server Error서버에서 예상치 못한 오류가 발생했을 때 나타나는 가장 일반적인 서버 오류 코드입니다.
🚀
결론 🔗
오늘은 면접에서 REST API에 대해 받을 수 있는 핵심적인 질문들을 살펴보았습니다.
- REST API는 자원을 URL로, 행위를 HTTP 메서드로 표현하는 규칙들의 모음입니다.
GET,POST,PUT,DELETE등 각메서드의 정확한 용도를 아는 것이 중요합니다.- RESTful하다는 것은 이 규칙들을 잘 지켜서 API를 설계했다는 의미입니다.
- 상태 코드는 서버와 클라이언트 간의 소통에서 필수적인 신호등 역할을 합니다.
이 개념들을 단순히 암기하기보다는, 왜 이런 규칙들이 생겨났을지(
클라이언트와 서버 간의 명확한 소통, 낮은 의존성 등
)를 함께 고민해 본다면 어떤 응용 질문이 나와도 자신 있게 대답할 수 있을 것입니다.
다음 면접 준비 편에서는 또 다른 단골 주제인 '브라우저 동작 원리'에 대해 알아보겠습니다.✅