์๋ ,
๋์ผํ ํ๋ก์ ํธ์ ๋ ๊ฐ์ ํธ์คํธ๋ฅผ ์ถ๊ฐํ๋ ค๊ณ ํฉ๋๋ค.
ํธ์คํธ 1 : https://abc.com/
ํธ์คํธ 2 : https://efg.com/
ํ์ฌ "HOST: https://abc.com "์ ์ฌ์ฉํ์ฌ ํ๋์ ํธ์คํธ๋ก ์์ ํ ์ ์์ง๋ง ๋์ผํ ํ๋ก์ ํธ์ ๊ตฌ์ฑ๋ ๋ ๊ฐ์ ํธ์คํธ๊ฐ ํ์ํฉ๋๋ค. ๋์ผํ ํ๋ก์ ํธ์์ ๋ ๊ฐ์ ํธ์คํธ๋ฅผ ์ ์ํ๋ ๋ฐฉ๋ฒ์ด ์์ต๋๊น?
๋ฏธ๋ฆฌ ๊ฐ์ฌ๋๋ฆฝ๋๋ค. ๋์์ฃผ์ธ์.
๋ฌธ์ ์ธ์ฌ,
ํ
์
์ด๊ฒ๋ ๊ถ๊ธํฉ๋๋ค. ์ฐ๋ฆฌ๋ ์ฌ๋ฌ ํ ์คํธ ํ๊ฒฝ์ ์ฌ์ฉํ๊ณ ์์ผ๋ฉฐ ์ฐจ์ด์ ์ ์ฐพ๊ธฐ ์ํด ๋ ์ฌ์ด๋ฅผ ์ ํํ ์ ์๋ ๊ฒ์ด ์ค์ํฉ๋๋ค.
ํ์ฌ๋ ์ง์ํ์ง ์์ง๋ง ํฅํ ์ด๋ฅผ ๊ฐ๋ฅํ๊ฒ ํ๋ ์๋ฃจ์ ์ ๊ฐ๋ฐ ์ค์ ๋๋ค.
์ด์ ๋ํ ์ ๋ฐ์ดํธ๊ฐ ์์ต๋๊น?
์ด ๋ฌธ์ ์ ๋ํ ํด๊ฒฐ์ฑ ์ด ์ด๋ฏธ ์์ต๋๊น?
๊ณต๊ฐ๊ฐ ์๋๋๋ค. ์ฐ๋ฆฌ๋ ์ด ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ ๋ฐฉ๋ฒ์ ๋ํด ๋ธ๋ ์ธ์คํ ๋ฐ์ ํ๊ณ ์์ผ๋ฉฐ ์ค๊ณ ๋ฐ ๋ฐฐํฌ ๋ฌธ์ ๋ฅผ ๋ถ๋ฆฌํ๋ ๊ฒ๊ณผ ๋ฌ๋ฆฌ ์ฌ๋ฌ HOST๊ฐ ์ฌ๋ฐ๋ฅธ ์๋ฃจ์ ์ธ์ง ํ์ ํ ์ ์์ต๋๋ค.
@Almad ์ด ๋ฌธ์ ์ ๊ด๋ จํ์ฌ ๋ช ๊ฐ์ง ํผ๋๋ฐฑ์ ์ ๊ณตํ๊ธฐ ์ํด ์ ์ฌ์ฉ ์ฌ๋ก๋ฅผ ์ค๋ช ํ๊ฒ ์ต๋๋ค.
Apiary ์ฌ์ฉ ์ฌ๋ก๋ ์์ ํ ๊ฐ๋ฐ์ ๋์๋ณด๋์ ์์ ๋ฌธ์๋ฅผ ํฌํจํ๋ ๊ฒ์ ๋๋ค. ์ฐ๋ฆฌ๋ ์ง๊ธ ์ถ๊ฐ ๊ธฐ๋ฅ, ํ๋ฌ๊ทธ์ธ ๋๋ ํ์ฅ์ ์ฌ์ฉํ ๊ณํ์ด ์์ต๋๋ค. ์ธ์ฆ, ์ฒญ๊ตฌ, ํต๊ณ, ๋ฆฌ์์ค ๊ฒ์ ๋ฑ๊ณผ ๊ฐ์ด ์์คํ ์ ์ฌ๋ฌ ๋ถ๋ถ(๋ง์ดํฌ๋ก ์๋น์ค)์ ๋ํด ์ฌ๋ฌ ํ์ ๋๋ฉ์ธ์ ์ฌ์ฉํฉ๋๋ค. ๋ณด์๋ค์ํผ ๊ฐ ํ์ ๋๋ฉ์ธ์ ์๋ก ๋ค๋ฅธ ๋๋ฉ์ธ์ ๋ด๋นํฉ๋๋ค.
Apiary์์ ๊ฐ์ฅ ๋งค๋ ฅ์ ์ผ๋ก ๋ณด์ด๋ ๊ฒ์ ์ฝ์ ๊ธฐ๋ฅ์ ๋๋ค. ๋์ ์ ์ค๋ช ํ ์ ์๊ณ ์ต์ข ์ฌ์ฉ์๋ ์ฝ์์ ํตํด ๋์ ์ ์คํํ ์ ์์ต๋๋ค. ๋ํ ์ธ์ด๋ฅผ ๋ณ๊ฒฝํ๊ณ ๋ค๋ฅธ ์ธ์ด๋ก ์์ ์ฝ๋๋ฅผ ๋ณต์ฌํ๋ ์ต์ ์ ์ถ๊ฐํฉ๋๋ค.
๊ทธ๋ฌ๋ ์ฌ๋ฌ ํ์ ๋๋ฉ์ธ์ ์ฌ์ฉํ๋ ์ต์ ์ด ์์ผ๋ฉด ๋ช ๊ฐ์ง ์ต์ ๋ง ๋จ์ต๋๋ค.
์ด๋ค ์ต์ ๋ ํ๋ฅญํด ๋ณด์ด์ง ์์ต๋๋ค. ์ฐ๋ฆฌ์ ๊ฒฝ์ฐ์ ์ด๋ค ์ถ์ฒ์ด ์์ต๋๊น?
๊ทธ๊ฒ์ ๋ํ ํด๊ฒฐ์ฑ ์ด ์์ ๊ฒ์ด์ง๋ง ๋ถํํ๋ SEC์ ๋ณํธ์ฌ ๋๋ฌธ์ ๊ทธ๊ฒ์ ๋ํด ์ด์ผ๊ธฐํ๊ณ ์ผ์ ์ ๋งํ ์ ์์ต๋๋ค.
๊ฐ๊น์ด ๋ฏธ๋๊ฐ ์ถฉ๋ถํ ํฌ๋ง์ ์ค ์ ์์ต๋๊น?
์ด๋ค ์ง์ ์ด ์์ต๋๊น?
host
๊ฐ์ฒด์ ๋ํ ์ง์์ ์ฃผ๋ก OAS3 ์๋ฒ ๊ฐ์ฒด ๋งคํ์ ์ง์ํ๊ธฐ ์ํด API ์์ ์ https://help.apiary.io/tools/interactive-documentation-v4/ ๋ ๋๋ฌ ์
๋ฐ์ดํธ๋ฅผ ๊ณ์ ์ง์ผ๋ด ์ฃผ์ญ์์ค.
ํ์ง๋ง API Blueprint์์ ์ง์์ ๋ํ ์งํ ์ํฉ์ ๋ณด์ง ๋ชปํ์ต๋๋ค.
๊ฐ์ฅ ์ ์ฉํ ๋๊ธ
์ด์ ๋ํ ์ ๋ฐ์ดํธ๊ฐ ์์ต๋๊น?