REST๋, REprensentational State Transfer์ ์ฝ์์ด๋ค. ๋ฐ๋ผ์, RESTful API๋ REST์ ๊ธฐ๋ณธ ์์น์ ์ ์งํจ API๋ฅผ ์๋ฏธํ๋ค.
REST๋ ํ๋์ ์ํคํ ์ณ๋ก, Resource Oriented Architecture์ด๋ค. API ์ค๊ณ์ ์ค์ฌ์ ์์(resource)๊ฐ ์๊ณ , HTTP Method๋ฅผ ํตํด ์์์ ์ฒ๋ฆฌํ๋๋ก ์ค๊ณํ๋ ๊ฒ์ด๋ค.
www์ ๊ฐ์ ๋ถ์ฐ ํ์ดํผ ๋ฏธ๋์ด ์์คํ ์ ์ํ ์ํํธ์จ์ด ์ํคํ ์ฒ์ ํ ํ์์ผ๋ก, ์์์ ์ ์ํ๊ณ ์์์ ๋ํ ์ฃผ์๋ฅผ ์ง์ ํ๋ ๋ฐฉ๋ฒ ์ ๋ฐ์ ๋ํ ํจํด
REST ํน์ง
- uniform interface
- URI๋ก ์ง์ ํ ๋ฆฌ์์ค์ ๋ํ ์กฐ์์ ํต์ผ๋๊ณ ํ์ ์ ์ธ ์ธํฐํ์ด์ค๋ก ์ํํ๋ ์ํคํ ์ณ ์คํ์ผ
- Stateless
- API ์๋ฒ๋ ์์ ์ ์ํ ์ํ์ ๋ณด๋ฅผ ๋ฐ๋ก ์ ์ฅํ์ง ์๊ณ , ๋ค์ด์จ ์์ฒญ์ ๋จ์ํ ์ฒ๋ฆฌํ๋ฉด ๋๋ค.
- ๋๋ฌธ์ ์๋น์ค์ ์์ ๋๊ฐ ๋์์ง๊ณ ์๋ฒ์์ ๋ถํ์ํ ์ ๋ณด๋ฅผ ๊ด๋ฆฌํ์ง ์์๋ ๋๋ค.
- caching
- HTTP๋ผ๋ ๊ธฐ์กด ์นํ์ค์ ๊ทธ๋๋ก ์ฌ์ฉํ๊ธฐ์, ์น์์ ์ฌ์ฉํ๋ ๊ธฐ์กด ์ธํ๋ผ๋ฅผ ๊ทธ๋๋ก ์ฌ์ฉํ ์ ์๋ค.
- ๋ฐ๋ผ์ HTTP๊ฐ ๊ฐ์ง ์บ์ฑ ๊ธฐ๋ฅ์ ์ ์ฉํ ์ ์๋ค.
- HTTP ํ๋กํ ์ฝ ํ์ค์์ ์ฌ์ฉํ๋ Last-Modified ํ๊ทธ๋ E-Tag๋ฅผ ์ด์ฉํ๋ฉด ์บ์ฑ ๊ตฌํ์ด ๊ฐ๋ฅํ๋ค/
- client-server
- REST ์๋ฒ๋ API๋ฅผ ์ ๊ณตํ๊ณ , ํด๋ผ์ด์ธํธ๋ ์ฌ์ฉ์ ์ธ์ฆ์ด๋ ์ปจํ ์คํธ(์ธ์ , ๋ก๊ทธ์ธ์ ๋ณด) ๋ฑ์ ์ง์ ๊ด๋ฆฌํ๋ ๊ตฌ์กฐ๋ก, ๊ฐ๊ฐ์ ์ญํ ์ด ํ์คํ ๊ตฌ๋ถ๋์ด์๋ค.
- ๋ฐ๋ผ์ ํด๋ผ์ด์ธํธ์ ์๋ฒ์์ ๊ฐ๋ฐํด์ผํ ๋ด์ฉ์ด ๋ช ํํด์ง๊ณ , ์๋ก๊ฐ์ ์์กด์ฑ์ด ์ค์ด๋ ๋ค.
- hierarchical system
- REST ์๋ฒ๋ ๋ค์ค ๊ณ์ธต์ผ๋ก ๊ตฌ์ฑ๋ ์ ์์ผ๋ฉฐ, ๋ณด์/๋ก๋๋ฐธ๋ฐ์ฑ/์ํธํ ๊ณ์ธต์ ์ถ๊ฐํด ๊ตฌ์กฐ์์ ์ ์ฐ์ฑ์ ๋ ์ ์๊ณ , Proxy, ๊ฒ์ดํธ์จ์ด ๊ฐ์ ๋คํธ์ํฌ ๊ธฐ๋ฐ์ ์ค๊ฐ ๋งค์ฒด๋ฅผ ์ฌ์ฉํ ์ ์๋ค.
- Self-descriptiveness
- REST API ๋ฉ์์ง๋ง ๋ณด๊ณ ๋ ์ด๋ฅผ ์ฝ๊ฒ ์ดํดํ ์ ์๋ ์์ฒด ํํ๊ตฌ์กฐ๋ก ๋์ด์๋ค.
RESTfull ํ๊ฒ API๋ฅผ ๋์์ธ ํ๋ค๋ ๊ฒ์ ์๋ฏธ
-
๋ฆฌ์์ค์ ํ์๋ฅผ ๋ช ์์ ์ด๊ณ ์ง๊ด์ ์ผ๋ก ๋ถ๋ฆฌํ๋ค.
- ๋ฆฌ์์ค๋ URI๋ก ํํ๋๋๋ฐ, ๋ฆฌ์์ค๊ฐ ๊ฐ๋ฆฌํค๋ ๊ฒ์ ๋ช ์ฌ๋ก ํํ๋์ด์ผํ๋ค.
- ํ์๋ HTTP Method๋ก ํํํ๊ณ ,
GET, POST, PUT(์ ์ฒด ์์ ), PATCH(์ผ๋ถ ์์ ), DELETE๊ฐ ์๋ค.
-
Message๋ Header์ Body๋ฅผ ๋ช ํํ๊ฒ ๋ถ๋ฆฌํด์ ์ฌ์ฉํ๋ค
- entity์ ๋ํ ๋ด์ฉ์ body์ ๋ด๋๋ค
- ์ ํ๋ฆฌ์ผ์ด์ ์๋ฒ๊ฐ ํ๋ํ ํ๋จ์ ๊ทผ๊ฑฐ๊ฐ ๋๋ ์ปจํธ๋กค ์ ๋ณด์ธ API ๋ฒ์ ์ ๋ณด, ์๋ต๋ฐ๊ณ ์ ํ๋ MIME ํ์ ๋ฑ์ header์ ๋ด๋๋ค.
- header์ body๋ http header์ http body๋ก ๋๋ ์ ์๊ณ , http body์ ๋ค์ด๊ฐ๋ json ๊ตฌ์กฐ๋ก ๋ถ๋ฆฌํ ์ ์๋ค.
-
API ๋ฒ์ ์ ๊ด๋ฆฌํ๋ค.
- ํ๊ฒฝ์ ํญ์ ๋ณํ๊ธฐ๋๋ฌธ์ API์ signature๊ฐ ๋ณ๊ฒฝ๋ ์๋ ์์์ ์ ์ํ์.
- ํน์ API๋ฅผ ๋ณ๊ฒฝํ ๋๋ ๋ฐ๋์ ํ์ํธํ์ฑ์ ๋ณด์ฅํด์ผํ๋ค.
-
์๋ฒ์ ํด๋ผ์ด์ธํธ๊ฐ ๊ฐ์ ๋ฐฉ์์ ์ฌ์ฉํด์ ์์ฒญํ๋๋ก ํ๋ค.
-
๋ธ๋ผ์ฐ์ ์ ์๋ฒ ๋ ๋ค json์ผ๋ก ๋ณด๋ด๋ , form-data ํ์์ผ๋ก ๋ณด๋ด๋ ํ๋๋ก ํต์ผํ๋ค.
-
๋ค๋ฅธ ๋ง๋ก ํํํ์๋ฉด, URI๊ฐ ํ๋ซํผ ์ค๋ฆฝ์ ์ด์ด์ผํ๋ค๋ ๋ง์ด๋ค.
-
์ฅ๋จ์
์ฅ์
- Open API๋ฅผ ์ ๊ณตํ๊ธฐ ์ฝ๋ค.
- ๋ฉํฐํ๋ซํผ ์ง์ ๋ฐ ์ฐ๋์ด ์ฉ์ดํ๋ค.
- ์ํ๋ ํ์ ์ผ๋ก ๋ฐ์ดํฐ๋ฅผ ์ฃผ๊ณ ๋ฐ์ ์ ์๋ค.
- ๊ธฐ์กด ์น ์ธํ๋ผ(HTTP)๋ฅผ ๊ทธ๋๋ก ์ฌ์ฉํ ์ ์๋ค.
๋จ์
- ์ฌ์ฉํ ์ ์๋ ๋ฉ์๋๊ฐ ์ ๋ค.
- ๋ถ์ฐํ๊ฒฝ์๋ ๋ถ์ ํฉํ๋ค.
- HTTP ํต์ ๋ชจ๋ธ์ ๋ํด์๋ง ์ง์ํ๋ค.