Skip to content

๐Ÿ’ซโญ๏ธAPI DOCS๋ฅผ ๋งŒ๋“ค๊ธฐ ์œ„ํ•˜์—ฌ APIDOC๋ฅผ ํ™œ์šฉํ•˜์˜€์Šต๋‹ˆ๋‹ค. SWAGGER๋“ฑ ์—ฌ๋Ÿฌ๊ฐ€์ง€๊ฐ€ ์žˆ์ง€๋งŒ, ๊ฐ€์žฅ ๊ฐ„ํŽธํ•˜๊ฒŒ ์‚ฌ์šฉํ• ์ˆ˜ ์žˆ๋Š”๊ฒƒ์œผ๋กœ ํŒ๋‹จ ๋˜์–ด ์šฐ๋ฆฌ๋Š” APIDOC์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

Notifications You must be signed in to change notification settings

EJunWhite/API_DOC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

API

API DOCS๋ฅผ ๋งŒ๋“ค๊ธฐ ์œ„ํ•˜์—ฌ APIDOC๋ฅผ ํ™œ์šฉํ•˜์˜€์Šต๋‹ˆ๋‹ค. SWAGGER๋“ฑ ์—ฌ๋Ÿฌ๊ฐ€์ง€๊ฐ€ ์žˆ์ง€๋งŒ, ๊ฐ€์žฅ ๊ฐ„ํŽธํ•˜๊ฒŒ ์‚ฌ์šฉํ• ์ˆ˜ ์žˆ๋Š”๊ฒƒ์œผ๋กœ ํŒ๋‹จ ๋˜์–ด ์šฐ๋ฆฌ๋Š” APIDOC์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

HOW TO INSTALL

npm install express -g
npm install apidoc -g

HOW TO RUN

sudo ./node_modules/apidoc/bin/apidoc -i source/ -o api_xxx_legacy/

source/ api ์†Œ์Šค ์œ„์น˜ api_xxx_legacy/ api๋ฌธ์„œ ๋งŒ๋“ค ์œ„์น˜

HOW TO USE

ํด๋” ๋ฐ ์†Œ์Šค ์„ค๋ช…

  • 'api_xxx'๋กœ ์‹œ์ž‘ํ•˜๋Š” ํด๋”๋Š” ์‹ค์ œ APIํ™” ๋˜์–ด์ง„ ์†Œ์Šค ๋‹จ์ด ์œ„์น˜ ํ•ฉ๋‹ˆ๋‹ค. ์‹ค์ œ APIDOCSํ™” ๋œ ์†Œ์Šค ์œ„์น˜ ์ž…๋‹ˆ๋‹ค.
api_xxx ์˜ 'xxx'๋Š” ์„œ๋น„์Šค ๋ช…์ž…๋‹ˆ๋‹ค.

  • 'XXX_xxx'๋กœ ์‹œ์ž‘ํ•˜๋Š” ํด๋”๋Š” ์‹ค์ œ APIํ™” ๋˜์–ด์ง„ ์†Œ์Šค ๋‹จ์ด ์œ„์น˜ ํ•ฉ๋‹ˆ๋‹ค. ์‹ค์ œ APIDOCSํ™” ๋œ ์†Œ์Šค ์œ„์น˜ ์ž…๋‹ˆ๋‹ค.
XXX_xxx ์˜ 'xxx'๋Š” ์„œ๋น„์Šค ๋ช…์ž…๋‹ˆ๋‹ค.

  • server_api.js : NodeJs ๋กœ ์„œ๋น„์Šค ์‹œ์ž‘์„ ํ•˜๊ฒŒ ๋˜๋ฉด ๋ชจ๋“  API๋ฅผ ๋ณผ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
XXX_xxx ์˜ 'xxx'๋Š” ์„œ๋น„์Šค ๋ช…์ž…๋‹ˆ๋‹ค.

CURRENT API

api_XXX_legacy

XXX legacy api์ž…๋‹ˆ๋‹ค. Legacy api๋Š” ๋ถ€์กฑํ•œ ๋ถ€๋ถ„์ด ์žˆ์–ด, ์ƒ˜ํ”Œ ํ˜•ํƒœ๋กœ๋งŒ ์•„์ฃผ ๊ฐ„๋žตํ•˜๊ฒŒ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ž์„ธํ•œ๊ฑด XXX LEGACY๋ฅผ ์ฐธ๊ณ ํ•˜๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.


api_XXX_new

์‹œ์Šคํ…œ ๊ฐœํŽธ ๋ฐ APIDOCS๋ฅผ ๋„์ž…ํ•˜์˜€์Šต๋‹ˆ๋‹ค.


About

๐Ÿ’ซโญ๏ธAPI DOCS๋ฅผ ๋งŒ๋“ค๊ธฐ ์œ„ํ•˜์—ฌ APIDOC๋ฅผ ํ™œ์šฉํ•˜์˜€์Šต๋‹ˆ๋‹ค. SWAGGER๋“ฑ ์—ฌ๋Ÿฌ๊ฐ€์ง€๊ฐ€ ์žˆ์ง€๋งŒ, ๊ฐ€์žฅ ๊ฐ„ํŽธํ•˜๊ฒŒ ์‚ฌ์šฉํ• ์ˆ˜ ์žˆ๋Š”๊ฒƒ์œผ๋กœ ํŒ๋‹จ ๋˜์–ด ์šฐ๋ฆฌ๋Š” APIDOC์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published