๐ฆ ๋ฒ๋ง API
AI ์์ด์ ํธ๋ฅผ ์ํ ๋ฒ๋ น์ ๋ณด์ผํฐ
๋ํ๋ฏผ๊ตญ ๋ฒ๋ น์ AI ์์ด์ ํธ๊ฐ ๊ฐํธํ๊ฒ ์ฐธ์กฐํ ์ ์๋๋ก ๋๋ ๋ฌด๋ฃ API์ ๋๋ค.
0. ์์ฝ
- ๊ตญ๊ฐ๋ฒ๋ น์ ๋ณด์ผํฐ ์ ๊ณต ๋ฒ๋ น 99.9% ์ด์์ ์๋กํ๋ฉฐ, ๋งค์ฃผ ํ ์์ผ ์ต์ ๋๊ธฐํํฉ๋๋ค.
- XML, HWP, PDF๋ฅผ ์ฌ์ ํ์ฑํ์ฌ ํ ๋ฐ์ดํฐ๋ฅผ ํฌํจํ ๋ชจ๋ ์ถ๋ ฅ์ JSON์ผ๋ก ์ ๊ณตํฉ๋๋ค.
- PostgreSQL๊ณผ ๋ฒกํฐ ๊ฒ์ ์์ง์ ์ฌ์ฉํ๋ฉฐ, ์ฃผ์ ์กฐ๋ฌธ ์ฝ 20๋ง๊ฑด์ ์๋ฏธ ๊ธฐ๋ฐ ๊ฒ์์ ์ง์ํฉ๋๋ค.
- ์ธ์ฆํค ์์ด ์ฌ์ฉ ๊ฐ๋ฅํ REST API์ด๋ฉฐ, ๋ถ๋น 100ํ ์ ํ์ด ์์ต๋๋ค. 500 ๋์์ ์ ์คํธ๋ ์ค ํ ์คํธ๋ฅผ ์๋ฃํ์์ต๋๋ค.
- ๋ก๊ทธ์ธ, IP, ์ฟผ๋ฆฌ ๋ฑ์ ๋ก๊น ํ์ง ์์ผ๋ฉฐ, ์ต๋ช ์๋ํฌ์ธํธ ํธ์ถ ๋น๋๋ง ์ง๊ณํฉ๋๋ค.
- ๋ฌด๋ฃ์ด๋ฉฐ ์์ตํ ๊ณํ์ด ์์ต๋๋ค.
1. ์๋ก ๋ฐ์ดํฐ ๋ฒ์ (2026. 3. 28. ๊ธฐ์ค)
- ๋ฒ๋ น ์ฝ 0.6๋ง๊ฑด ยท ํ๋ก ์ฝ 17.2๋ง๊ฑด ยท ํ์ฌ๊ฒฐ์ 37,577๊ฑด ยท ์์ ์ฝ 11.4๋ง๊ฑด ยท ํ์ ๊ท์น ์ฝ 2.4๋ง๊ฑด
- ์กฐ์ฝ ์ฝ 0.4๋ง๊ฑด (์์ ์ฝ 0.3๋ง / ๋ค์ 751) ยท ํด์๋ก ์ฝ 0.9๋ง๊ฑด ยท ์์น๋ฒ๊ท ์ฝ 15.9๋ง๊ฑด
- ์ธ์ฉ๊ด๊ณ ์ฝ 13.7๋ง๊ฑด ยท ์ฐํ ์ฝ 220.5๋ง๊ฑด
- ๊ตญํ ์์ ๋ฐ ๊ด๋ จ ํ์๋ก ํฌํจ
- ์ถ์ฒ: ๋ฒ์ ์ฒ Open API, ๊ตญํ Open API
2. ์ ๊ณต ๋ฐ์ดํฐ ํ์
- ๋ฒ์ ์ฒ XML ์๋ณธ์ ํ์ฑํ์ฌ ์ ํญ๋ชฉ์ JSON์ผ๋ก ๊ตฌ์กฐํํ์์ต๋๋ค.
- ๋ณํ์ ์์์ ์ฝ 5๋ง๊ฐ์ ํ๋ฅผ HWP, PDF ์๋ณธ์์ ์ถ์ถํ์ฌ JSON ํ ์ด๋ธ๋ก ๋ณํํ์์ต๋๋ค. ์ ๋ณํฉ ์ ๋ณด๋ ๋ณด์กด๋ฉ๋๋ค.
- ์กฐ๋ฌธ์ ํธ, ์ฅ, ์ , ๊ด, ์กฐ, ํญ, ํธ, ๋ชฉ ๋จ์๋ก ๋ถํดํ์์ผ๋ฉฐ ์ฝ 589๋ง๊ฑด์ ๋๋ค.
- ๋ฒ๋ น ์ ์ ์ฌ์ฌ ๊ธฐ์ค, ํ์ ๊ท์น ์ ์์ฌ์ฌ ๊ธฐ์ค, ํ๋ฒ์ฌํ์ค๋ฌด์ ์, ๋ฒ์ ์ ๋ฌดํธ๋, ๋ฒ๋ น์ ๋น๊ธฐ์ค ๋ฑ ์ฐธ๊ณ ๋ฌธ์ 5๊ถ์ ํค์๋ ๋ฐ ์๋ฏธ ๊ธฐ๋ฐ์ผ๋ก ๊ฒ์ํ ์ ์์ต๋๋ค.
3. ๊ฒ์ ์์คํ
- Cloudflare Workers์ PostgreSQL ๊ธฐ๋ฐ ๊ฒ์ ์์ง์ ์ฌ์ฉํฉ๋๋ค.
- ํค์๋, ์๋ฏธ ๊ธฐ๋ฐ, ํผํฉ ๊ฒ์์ 3๊ฐ์ง ๋ฐฉ์์ ์ง์ํฉ๋๋ค. ๋ฒ๋ น๊ณผ ํ๋ก ๋ชจ๋ ๋์ผํ๊ฒ ์ฌ์ฉํ ์ ์์ต๋๋ค. ์๋ฏธ ๊ธฐ๋ฐ ๊ฒ์์ ์ ํํ ํค์๋ ๋์ "์์ฐจ์ธ ๋ณดํธ ์๊ฑด"์ฒ๋ผ ์๋ฏธ๋ก ๊ฒ์ํ๋ ๋ฐฉ์์ ๋๋ค.
4. ์ธํฐํ์ด์ค
- 6๊ฐ ์๋ํฌ์ธํธ, 13๊ฐ action์ REST API์ MCP ์๋ฒ๋ฅผ ์ ๊ณตํฉ๋๋ค. OpenAPI 3.0 ์คํ์ /openapi.json์์ ํ์ธํ ์ ์์ต๋๋ค.
- ๋ฒ๋ฅ ์์ ์ํ๋ น, ์ํ๊ท์น์ผ๋ก ์ด์ด์ง๋ ์์ ์กฐ๋ฌธ์ ํ ๋ฒ์ ์์ฒญ์ผ๋ก ์กฐํํ ์ ์์ต๋๋ค.
- ์์ด์ ํธ๊ฐ ์ธ์ฉํ ์กฐ๋ฌธ์ด๋ ํ๋ก๊ฐ ์ค์ ๋ก ์กด์ฌํ๋์ง ๊ฒ์ฆํ๋ ํ๊ฐ ๋ฐฉ์ง์ฉ ์ธ์ฉ ๊ฒ์ฆ ๊ธฐ๋ฅ์ ์ ๊ณตํฉ๋๋ค.
- ์ข ํฉ ์กฐํ ๊ธฐ๋ฅ์ผ๋ก ๋ฒ๋ น 1ํ ์์ฒญ ์ ์กฐ๋ฌธ, ํ๋ก, ์์, ์ธ์ฉ ๋ฒ๋ น๊น์ง ํ ๋ฒ์ ๋ฐํํฉ๋๋ค.
- ์กฐ๋ฌธ ์กฐํ 5ms, ํ๋ก ์์ธ 9ms์ ์๋ต ์๋๋ฅผ ์ ๊ณตํฉ๋๋ค.
- 500 ๋์ ์ ์, 4๋ถ ๋ด 20,000๊ฑด ์ด์์ ์์ฒญ ์ฒ๋ฆฌ๋ฅผ ํ์ธํ์์ต๋๋ค.
5. ๊ฐ์ธ์ ๋ณด ๋ณดํธ
- ์ธ์ฆํค, ๋ก๊ทธ์ธ, ํ์๊ฐ์ ์์ด ์ฌ์ฉํ ์ ์์ต๋๋ค.
- IP ์ฃผ์, ๊ฒ์์ด ๋ฑ ๊ฐ์ธ ์๋ณ ๊ฐ๋ฅ ์ ๋ณด๋ฅผ ์์งํ์ง ์์ต๋๋ค. ํด๋ผ์ด์ธํธ ์ ํ(๋ธ๋ผ์ฐ์ /์์ด์ ํธ ๊ตฌ๋ถ)๋ง ์ต๋ช ์ผ๋ก ์ง๊ณํฉ๋๋ค.
- ์์ฒญ ๋ณธ๋ฌธ(๊ฒ์์ด ํฌํจ)์ ์๋ฒ์ ์ ์ฅํ์ง ์์ต๋๋ค.
- ์๋น์ค ์์ ์ฑ ๋ชจ๋ํฐ๋ง ๋ชฉ์ ์ผ๋ก ์ต๋ช ์๋ํฌ์ธํธ๋ณ ํธ์ถ ๋น๋๋ง ์ง๊ณํฉ๋๋ค.
- ํผ๋๋ฐฑ์ ๋ฐ๋์ ์ฌ์ฉ์ ์น๋ ํ์๋ง ์ ์ก๋๋ฉฐ, ์์ด์ ํธ๊ฐ ๋จ๋ ์ผ๋ก ๋ฐ์ ํ ์ ์์ต๋๋ค.
6. Acknowledgements
- ๋ํ๋ฏผ๊ตญ ๋ฒ๋ น์ SSOT, ๊ตญ๊ฐ๋ฒ๋ น์ ๋ณด์ผํฐ๋ฅผ ์ด์ํด์ฃผ์๋ ๋ฒ์ ์ฒ์ ๊ฐ์ฌ๋๋ฆฝ๋๋ค.
- ์์ยท์ ๋ฒ ๋ฐ์ดํฐ๋ฅผ ์ ๋ฆฌํ์ฌ ๊ฐ๋ฐฉํด์ฃผ์๋ ๊ตญํ์ฌ๋ฌด์ฒ์๋ ๊ฐ์ฌ๋๋ฆฝ๋๋ค.
IP, ๊ฒ์์ด, ๊ฐ์ธ์ ๋ณด ๋ฑ์ ์ผ์ ์์งํ์ง ์์ผ๋ฉฐ, ์ต๋ช ํธ์ถ ๋น๋ ๋ฐ ํด๋ผ์ด์ธํธ ์ ํ๋ง ์ง๊ณํฉ๋๋ค.
API ์ถ๋ ฅ(๋ฒ์ ์ฒ, ๊ตญํ ์ถ์ฒ)์ ์ฐธ๊ณ ์ฉ์ผ๋ก ๋ฒ์ ํจ๋ ฅ์ด ์์ต๋๋ค.
help@beopmang.org