API DOCS๋ฅผ ๋ง๋ค๊ธฐ ์ํ์ฌ APIDOC๋ฅผ ํ์ฉํ์์ต๋๋ค. SWAGGER๋ฑ ์ฌ๋ฌ๊ฐ์ง๊ฐ ์์ง๋ง, ๊ฐ์ฅ ๊ฐํธํ๊ฒ ์ฌ์ฉํ ์ ์๋๊ฒ์ผ๋ก ํ๋จ ๋์ด ์ฐ๋ฆฌ๋ APIDOC์ ์ฌ์ฉํฉ๋๋ค.
npm install express -g
npm install apidoc -g
sudo ./node_modules/apidoc/bin/apidoc -i source/ -o api_xxx_legacy/
source/ api ์์ค ์์น api_xxx_legacy/ api๋ฌธ์ ๋ง๋ค ์์น
ํด๋ ๋ฐ ์์ค ์ค๋ช
- 'api_xxx'๋ก ์์ํ๋ ํด๋๋ ์ค์ APIํ ๋์ด์ง ์์ค ๋จ์ด ์์น ํฉ๋๋ค. ์ค์ APIDOCSํ ๋ ์์ค ์์น ์ ๋๋ค.
api_xxx ์ 'xxx'๋ ์๋น์ค ๋ช
์
๋๋ค.
- 'XXX_xxx'๋ก ์์ํ๋ ํด๋๋ ์ค์ APIํ ๋์ด์ง ์์ค ๋จ์ด ์์น ํฉ๋๋ค. ์ค์ APIDOCSํ ๋ ์์ค ์์น ์ ๋๋ค.
XXX_xxx ์ 'xxx'๋ ์๋น์ค ๋ช
์
๋๋ค.
- server_api.js : NodeJs ๋ก ์๋น์ค ์์์ ํ๊ฒ ๋๋ฉด ๋ชจ๋ API๋ฅผ ๋ณผ์ ์์ต๋๋ค.
XXX_xxx ์ 'xxx'๋ ์๋น์ค ๋ช
์
๋๋ค.
XXX legacy api์ ๋๋ค. Legacy api๋ ๋ถ์กฑํ ๋ถ๋ถ์ด ์์ด, ์ํ ํํ๋ก๋ง ์์ฃผ ๊ฐ๋ตํ๊ฒ ์ ๊ณตํฉ๋๋ค. ์์ธํ๊ฑด XXX LEGACY๋ฅผ ์ฐธ๊ณ ํ๊ธฐ ๋ฐ๋๋๋ค.
์์คํ ๊ฐํธ ๋ฐ APIDOCS๋ฅผ ๋์ ํ์์ต๋๋ค.