API
2
API :: API Versioning ?
1
2024.04.26
๋ฐฑ์๋๋ฅผ ๊ฐ๋ฐํ๋ ๊ฐ๋ฐ์๋ผ๋ฉด API๋ฅผ ๋ง๋ค๊ณ ๋ฐฐํฌํ ๊ฒฝํ์ด ์์ ๊ฒ์ด๋ค.์ด๋ฐ API๋ ํ๋ฒ ๋ง๋ค๊ณ ๋ฐฐํฌํ๋ฉด, ์ญ์ ํ๊ฑฐ๋ ๋ณ๊ฒฝํ๋ ๊ฒ ์ด๋ ค์์ง๊ฒ ๋๋๋ฐ.. ๊ทธ๋์ API Versioning์ผ๋ก ์ด๋ฅผ ๊ด๋ฆฌํ๊ฒ ๋๋ค..! API Versioning?API์ ๋ณ๊ฒฝ ์ฌํญ์ ๊ด๋ฆฌํ๊ณ ์ถ์ ํ๋ ํ๋ก์ธ์ค. ๋ณ๊ฒฝ ์ฌํญ์ API ์ฌ์ฉ์์๊ฒ ์ ๋ฌํ๋ ๊ฒ ๋ํ ํฌํจ ๋จ. API์ ์์ฐ์์ ์๋น์๊ฐ ๊ณต๊ฐ์ธ์ง, ๋น๊ณต๊ฐ์ธ์ง์ ๊ด๊ณ์์ด API๊ฐ ๋ฐ์ ํจ์ ๋ฐ๋ผ ๋๊ธฐํ๋ฅผ ์ ์งํ๋ ๊ฒ์ด ์ค์ํ๋ฐใ
ก, ์ด๋ฅผ ์ํด API Versioning์ ํ๋ค๊ณ ์๊ฐํ๋ฉด ๋๋ค. API Versioning ๋ฐฉ๋ฒ๋ณดํต ๋ค๋ฅธ ํ๋ก๊ทธ๋จ๋ค์ ๋ณ๊ฒฝ, ๋ณด์ ํด์ ์ฌ ๋ฐฐํฌ ํ ๋ 1.0.1 ํํ๋ก tag ๋ publish๋ฅผ ์งํํ๊ฒ ๋๋๋ฐ,API ๋ ์ด๋ค ๋ฐฉ๋ฒ์ผ๋ก Ver..

SpringBoot :: Swagger API ์ฐ๋
2023.10.26
dev. environment. SpringBoot 3.1.1 Java 17 ์ค์จ๊ฑฐ(Swagger) ๋? ๊ฐ๋ฐ์๊ฐ REST API ์๋น์ค๋ฅผ ์ค๊ณ, ๋น๋, ๋ฌธ์ํํ ์ ์๋๋ก ํ๋ ํ๋ก์ ํธ REST API๋ฅผ ๋ฌธ์ํํ๋ ๋๊ตฌ์ด๋ฉฐ, API์ ๋ํ ๋ช
์ธ(Spec)์ ๊ด๋ฆฌํ๊ธฐ ์ํ ํ๋ก์ ํธ API๊ฐ ์์ ๋๋๋ผ๋ ๋ฌธ์๊ฐ ์๋์ผ๋ก ๊ฐฑ์ . 2011 ๋
์ ์ฒ์ ๋์
๋ ๊ฐ๋
๊ธฐ์กด, ์๋๋ ์์
๋ฑ ์๊ธฐ ์์ฑํ๋ ๋ฌธ์ํ API ๋ช
์ธ์์ ๋ฌ๋ฆฌ ์๋ฒ์ ์ผ์ ์
ํ
์ ํด์ฃผ๋ฉด API ๋ช
์ธ์๊ฐ ๊ฐฑ์ ๋๋ค. ๋ฐฑ์๋ ๊ฐ๋ฐ์์ ๊ฒฝ์ฐ ํด๋ผ์ด์ธํธ๋ฅผ ๊ฐ๋ฐํ๋ ํ๋ก ํธ์๋ ๊ฐ๋ฐ์์ ์ํต์ ํ๋ ค๋ฉด API ๋ช
์ธ์๊ฐ ๊ผญ ํ์ํ๊ฒ ๋๋๋ฐ ์ด๊ฑธ ํ๋ํ๋ ๋ช
์ธํ๊ณ ์๋ ๊ฒ๋ ๊ฝค๋ ํฐ ์ผ๋ก ํ์
๋๋ค. ์ด๋ฐ ์
๋ฌด ๋ก์ค๋ฅผ ์ค์ด๊ธฐ ์ํด ์๋ฒ ๋จ์ ์ ์ฉํ๋ ๊ฒ์ด ๋ฐ๋ก๋ฐ..