์๋ ํ์ธ์ ์ฌ๋ฌ๋ถ, ์ง๋ฌธ์ ๋ฐ์ด๋ค์ด์ ์ฃ์กํฉ๋๋ค. ํ์ง๋ง ์ด ํ๋ก์ ํธ์ Google์ ๊ฒ์ํ์ง๋ง ์ด ์์ ์ ์ํํ๋ ๋ฐฉ๋ฒ์ ์ฐพ์ ์ ์์์ต๋๋ค. ์ด ๋งํฌ์ Redocly ๋ฌธ์๋ Redocly yaml ํ์ผ https://redoc.ly/docs/api-reference-docs/console-overview/#enable -the-try-it-api-console์์ ์ด๋ฅผ ์ํํ๋ ๋ฐฉ๋ฒ์ ์ค๋ช ํ์ง๋ง ์ ๋ Docker/k8s ์ค์น์์ ์ํํ๋ ๋ฐฉ๋ฒ์ ์ ๋ชจ๋ฅด๊ฒ ์ต๋๋ค. ์ ์ฉ๋๋ ํ๊ฒฝ ๋ณ์๊ฐ ํ์๋์ง ์์ต๋๋ค. ๋์์ ์ฃผ์ ์ ๋ฏธ๋ฆฌ ๊ฐ์ฌ๋๋ฆฝ๋๋ค.
์ข์ ์ง๋ฌธ. APICurio studio์์ "Try It" ๊ธฐ๋ฅ์ ํ์ฑํํ ์ ์๋ ๋ฐฉ๋ฒ์ด ์๋์ง ์๊ฒ ๋์ด ๊ธฐ์ฉ๋๋ค.
ReDoc์ Try It ๊ธฐ๋ฅ์ ์คํ ์์ค ์ ํ์ ํฌํจ๋์ด ์์ง ์์ ๊ฒ์ผ๋ก ์๊ณ ์์ต๋๋ค. ๊ทธ๋์ Studio์์ ํ์ฑํํ๋ ๋ฐฉ๋ฒ์ด ์๋ค๊ณ ์๊ฐํฉ๋๋ค. ๋ด๊ฐ ํ๋ ธ๋ค๋ฉด ๋๋ ๊ทธ๊ฒ์ ์๊ฒ๋์ด ๋งค์ฐ ๊ธฐ์ ๊ฒ์ ๋๋ค. :)
@EricWittmann
RapiDoc ๋ฐ SwaggerUI์๋ ์ฌ์ฉํด ๋ณด๊ธฐ ๊ธฐ๋ฅ์ด ์์ง๋ง Redoc์๋ ์์ต๋๋ค. ๋ฌธ์ UI ์ฌ์ด๋ฅผ ์ ํํ ์ ์์ผ๋ฉด ์ข๊ฒ ๋๋ฐ, ๊ทธ๋ ๊ฒ ํ ๊ณํ์ ์๋์?
๋ผํผ๋ฅ
https://mrin9.github.io/RapiDoc/index.html
์ค์จ๊ฑฐ UI
https://swagger.io/tools/swagger-ui/
ํฅ๋ฏธ๋กญ๊ฒ๋ ๋ฏธ๋ฆฌ๋ณด๊ธฐ ๊ธฐ๋ฅ์์ Rapidoc์ ๋ํ ์คํ์ ์ธ ์ง์์ด ์ด๋ฏธ ์์ต๋๋ค. ๋ฏธ๋ฆฌ๋ณด๊ธฐ URL์ &rid=rapidoc
๋ฅผ ์ถ๊ฐํ๋ฉด ๋ณผ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด:
๊ด๋ จ ์ฝ๋๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค.
Swagger UI์ ๊ฐ์ ๋ค๋ฅธ ๋ ๋๋ฌ์ ๋ํ ๊ธฐ์ฌ๋ ์ด๋ ต์ง ์์ ๊ฒ์ ๋๋ค!
์ฟจ, ์ ๋ Rapidoc์ ๋ชจ์๊ณผ ๋๋์ด ๋ง์์ ๋ญ๋๋ค. ํ์ง๋ง Apicurio์์ ์ฌ์ฉํด ๋ณด๊ธฐ ๊ธฐ๋ฅ์ด ๋นํ์ฑํ๋์ด ์์ต๋๋ค.
https://github.com/Apicurio/apicurio-studio/blob/dfc277b03032562e4a3d37f16c851159340495b0/front-end/servlet/src/main/resources/io/apicurio/studio/fe/template/servlets/preview_rap8
ํ์ฑํํ๋ ค๋ฉด allow-try=true
ํ๊ฑฐ๋ ์์ฑ์ true๋ก ์ ๊ฑฐํ๋ ๊ฒ์ด ๊ธฐ๋ณธ๊ฐ์
๋๋ค.
์ ์ - ์ฃ์กํฉ๋๋ค. ํด๋น ๊ธฐ๋ฅ์ ํน๋ณํ ๋นํ์ฑํํ ๊ฒ์ ์์์ต๋๋ค. ๋๋ ์๊ฐ ๊ณผ์ ์ ๊ธฐ์ตํ์ง ๋ชปํ์ง๋ง ์๋ง๋ ๋ด API ์ค๋ช ์ค ์ด๋ ๊ฒ๋ ๊ทธ๋ค์ ๋ท๋ฐ์นจํ๋ ์ค์ ์๋น์ค๊ฐ ์์์ ๊ฒ์ ๋๋ค.
์ฌ๊ธฐ์์ ์ด๋ฌํ ๊ธฐ๋ฅ์ ๋ ์ฝ๊ฒ ํ์ฑํ/๋นํ์ฑํํ ์ ์๋ ์์ ์ด ์๋ค๊ณ ์๊ฐํฉ๋๋ค. ๊ธฐ๋ถ์ ๊ด์ฌ์ด ์๋ ๋ชจ๋ ๋ถ๋ค์๊ฒ ๊ธฐ๊บผ์ด ์๋ดํด ๋๋ฆฌ๊ฒ ์ต๋๋ค! ์ฌ์ฉ์๊ฐ ๋ ๋๋ฌ ์ค์์ ์ ํํ๊ณ , ๊ธฐ๋ณธ ๋ ๋๋ฌ๋ฅผ ์ค์ ํ๊ณ , ๋ ๋๋ฌ๋ฅผ ์ ์ญ์ ์ผ๋ก ๋๋ ๋์์ธ๋ณ๋ก ๊ตฌ์ฑํ๋ ๋ฐฉ๋ฒ์ ๋ํด ์๊ฐํด์ผ ํฉ๋๋ค.
๊ธฐ์ฌํ๋ ๋ฐ ๊ด์ฌ์ด ์์ ์ ์์ต๋๋ค. ์ฐ๋ฝ์ ๋๋ฆฌ๊ฒ ์ต๋๋ค!
๊ฐ์ฅ ์ ์ฉํ ๋๊ธ
๊ธฐ์ฌํ๋ ๋ฐ ๊ด์ฌ์ด ์์ ์ ์์ต๋๋ค. ์ฐ๋ฝ์ ๋๋ฆฌ๊ฒ ์ต๋๋ค!