01/25(목) 내일배움캠프 Java 24일차 TIL - REST API

 

📖  오늘의 학습 키워드

• REST

 

🥔  REST

Representational State Transfer의 약자로, 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것.

 

1. HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고,
2. HTTP Method(POST, GET, PUT, DELETE, PATCH 등)를 통해
3. 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다.

❗️ CRUD Operation

 

CRUD는 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인

Create(생성), Read(읽기), Update(갱신), Delete(삭제)를 묶어서 일컫는 말로 
REST에서의 CRUD Operation 동작 예시는 다음과 같습니다.

Create : 데이터 생성(POST)
 - POST : 등록 + a
Read : 데이터 조회(GET)
 - GET : 조회
Update : 데이터 수정(PUT, PATCH)
 - PUT : 전체 수정
 - PATCH : 일부 수정
Delete : 데이터 삭제(DELETE)
 - DELETE : 삭제

 

 

🥔  REST API

REST API란 REST의 원리를 따르는 API를 말합니다.

표준은 없습니다. (세세한 부분이 회사마다, 팀마다, 사람마다, 나라마다, 문화마다 다르다)

소통에 드는 리소스를 줄이기 위해쓰입니다.

 

1. 동사보단 명사를, 단수보단 복수를

/member/get/item/hello (x)

/members/items (o)

 

2. 마지막에 / 넣지 않기

/members/ (x)

/members (o)

 

3. _ 대신 - 사용 + 대문자 사용하지 않기

/restful_services (x)

/restful-services (o)

 

4. 확장자 포함하지 않기(svg, png, exe 등)

/image.svg (x)

/images (o)

 

5. 계층화

/items/{memberId}/members/{itemId} (x)

/members/{memberId}/items/{itemId} (o)

 

📚  오늘의 회고

REST에 대해서 그냥 들어만 봤지만, 이렇게 정리하는 것은 처음인 것 같아서

흥미로웠습니다.