RESTful API란?

🥕 RESTful API란?

REpresentational State Transfer의 약자로 소프트웨어 프로그램 아키텍처의 한 형식 
두 컴퓨터 시스템이 인터넷을 통해 정보를 안전하게 교환하기 위해 사용하는 인터페이스로
RSET는 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미한다
=> HTTP Method(POST, GET, PUT, DELETE, PATCH 등)을 통해서 함

 

💡 HTTP Method

CRUD Operation이란?

대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인
Create(생성), Read(읽기), Update(갱신), Delete(삭제)를 묶어서 일컫는 말

Create : 데이터 생성(POST)
Read : 데이터 조회(GET)
Update : 데이터 수정(PUT, PATCH)
Delete : 데이터 삭제(DELETE)

🥕 API란?

웹 API는 클라이언트와 웹 리소스 사이의 게이트웨이

 

이전포스팅에서 비유해서 설명해두었다.

https://hanol2.tistory.com/7

API란 무엇인가

 

클라이언트

웹에서 정보에 엑세스하려는 사용자
ex) api를 사용하는 사람, 소프트웨어 시스템

 

리소스

다양한 애플리케이션이 클라이언트에게 제공하는 정보
클라이언트에 리소스를 제공하는 시스템을 서버라고도 함
조직은 API를 사용하여 리소스를 공유하고 보안, 제어 및 인증을 유지하면서 웹 서비스를 제공함
ex) 이미지, 동영상, 텍스트, 숫자 또는 모든 유형의 데이터

 

 

🥕 REST의 구성요소

자원(Resource) - URL
행위(Verb) - Http Method
표현(Representations)

 

1. 자원 (Resource) URL

• 모든 자원에 고유한 ID가 존재하고, 이 자원은 Server에 존재한다.
• 자원을 구별하는 ID는 /movie/movie_name/1 와 같은 HTTP URI 이다.
• Client는 URI를 이용해서 자원을 지정하고 해당 자원의 상태(정보)에 대한 조작을 Server에 요청한다.

2. 행위 (Verb) - Http Method

• HTTP 프로토콜의 Method를 사용한다.
• HTTP 프로토콜은 GET, POST, PUT, DELETE와 같은 메서드를 제공함

3. 표현 (Representaion of Resource)

• Client가 자원의 상태 (정보)에 대한 조작을 요청하면 Server는 이에 적절한 응답 (Representation)을 보낸다
• REST에서 하나의 자원은 JSON, XML, TEXT, RSS 등 여러 형태의 응답을 받을 수 있다.
• 현재는 JSON으로 주고 받는 것이 대부분이다.

 

❗REST API 와 RESTful API의 차이?

REST API 

=> REST 기반으로 서비스 API를 구현한 것

RESTful 하다?

REST 원리를 따르는 시스템은 RESTful이란 용어로 지칭

=> ‘REST API’를 제공하는 웹 서비스를 ‘RESTful’하다고 할 수 있다.

 

🥕 REST API 설계 규칙

1) 명사, 소문자 => 동사x
2) 명사는 복수형
3) URI 마지막은 / 포함x
4) URI는 언더바x 하이픈 사용 -
5) 파일의 확장자를 표시x