[TIL] Day32
[SEB FE] Day32

☑️ REST API

Representational State Transfer

웹에서 사용되는 모든 데이터/자원(Resource)을 HTTP URI로 표현하고,
HTTP 프로토콜을 통해 요청과 응답을 정의하는 방식

📎 Richardson의 REST 성숙도 모델 (RMM)

Level	Description
0단계	HTTP 프로토콜 사용
1단계	개별 리소스와의 통신 준수
2단계	HTTP 메소드 원칙 준수	→ HTTP API
3단계	HATEOAS 원칙 준수	→ REST API

0️⃣ 단계

HTTP 프로토콜 사용 ← REST API 작성 기본 단계

✋ 0단계의 경우, 해당 API를 REST API라고 할 순 ❌

1️⃣ 단계

개별 Resource와의 통신 준수

👉 모든 자원은 개별 리소스에 맞는 엔드포인트(Endpoint) 사용해야 하며, 요청하고 받는 자원 정보를 응답으로 전달해야 함
➕ 리소스 사용에 대한 성공/실패 여부 함께 반환

✋ Endpoint 작성시 리소스에 초점을 두어 명사 형태 단어로 작성하는 것이 바람직
(동사, 행위 단어 사용 지양)

2️⃣ 단계

CRUD에 맞게 적절한 HTTP 메서드를 사용하는 것에 중점

🫶 HTTP 메서드 사용 규칙 유의 사항

Method	Rule
GET	서버 데이터를 변화시키지 않는 요청에 사용
POST	요청마다 새로운 리소스 생성 (멱등성❌)
PUT	요청마다 같은 리소스 반환 (멱등성⭕️) 교체 용도로 사용 ✋ 매 요청마다 같은 리소스를 반환하는 특징 ⇒ 멱등(idempotent)하다
PATCH	수정 용도로 사용 ✋ PUT과 비슷하나 구분하여 사용해야 함

3️⃣ 단계

HATEOAS(Hypertext As Engine Of Application State) 하이퍼미디어 컨트롤 적용
✋ 요청은 2단계와 동일하지만, 응답엔 리소스 URI를 포함한 링크 요소 삽입하여 작성해야 함

📎 Open API

누구에게나 열려있는 API
✋ But, 무제한으로 이용 가능하다는 의미 ❌ (정해진 이용 수칙, 제한사항이 존재할 수도 있음)

📎 API Key

서버의 문을 여는 Key로써, API를 이용하려면 API Key 필요

➰ 로그인한 User에게 자원에 접근할 수 있는 권한을 API Key 형태로 제공
➰ 데이터 요청시 API Key를 같이 전달해야 원하는 응답을 받을 수 있음

---

✍️
오늘은 그래도 시간이 여유로운 날 🫶
저녁에 첨부터 복습 좀 하고, 개발 도서도 읽고 정리하기 💪