[REST] 🎯 REST API가 뭔가요?

📋 기술 면접 홈 바로가기

⬛ 개념

💡 REST (REpresental State Transfer)

자원을 정의하고 자원에 대한 주소를 할당하는 네트워크 아카텍처 원리들의 집합입니다.

그대로 번역하면 자원의 표현에 의한 상태 전달이라는 뜻입니다.

💡 RESTful API

REST한 아키텍처의 제약조건을 준수해서 만든 프로그래밍 인터페이스를 말합니다.

⬛ 구성 요소

💡 자원 (Resource)

서버측에 저장돼 있는 가공되지 않은 정보 자원을 말합니다. 다양한 형태 (format) 로 가공되어 표현될 수 있습니다.
HTTP Request Line의 URI에 자원의 식별자가 담깁니다.

• URL은 개별 리소스를 식별하는 주소입니다.

💡 표현 (Representation)

특정 시점에 특정 포맷으로 가공된 리소스를 말합니다.
HTTP Header와 Payload에 표현 정보가 담깁니다.

ex) text/html, application/json, text/xml, images/jpg 등

• 모든 HTTP Payload에는 Resource가 아닌 Representation이 담깁니다.

💡 행위 (Verb)

특정 리소스에 대해 요청할 동작의 종류를 나타냅니다.
HTTP Request Line의 Method에 행위 정보가 담깁니다.

ex) POST, GET, PUT, PATCH, DELETE 등

⬛ RESTful한 URI 표현법

✅	명칭	설명
✅	Collection	리소스들의 묶음입니다. 서버가 리소스의 식별자를 결정합니다. 복수로 표현합니다.
✅	Document	Collection 내의 단일 리소스입니다. 숫자 또는 단수의 문자를 식별자로 갖습니다.
	Controller	HTTP Method로 표현하지 못하는 동작을 표현합니다.
	Store	리소스 묶음입니다. 클라이언트가 리소스의 식별자를 결정합니다. 복수로 표현합니다.

• Collection POST 요청 예시 : /comments
• Store POST 요청 예시 : /comments/{commentId}

⬛ 작성법

1. ⬛ 요청 URL은 명사로 표현합니다.
2. ✅️ 띄어쓰기는 kebab-case로 작성합니다.
3. ✅️ Collection은 복수형 명사를 씁니다.
4. ✅️ Controller는 동사를 씁니다.
5. ⬛ 파일 확장자를 붙이지 않습니다.
6. ✅️ 소문자로 작성합니다.
7. ⬛ 마지막에 /를 붙이지 않습니다.