๐Ÿฆ’ ๋ฒ•๋ง API

โ†

AI ์—์ด์ „ํŠธ๋ฅผ ์œ„ํ•œ ๋ฒ•๋ น์ •๋ณด์„ผํ„ฐ

๋Œ€ํ•œ๋ฏผ๊ตญ ๋ฒ•๋ น์„ AI ์—์ด์ „ํŠธ๊ฐ€ ๊ฐ„ํŽธํ•˜๊ฒŒ ์ฐธ์กฐํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•๋Š” ๋ฌด๋ฃŒ API์ž…๋‹ˆ๋‹ค.

0. ์š”์•ฝ

  1. ๊ตญ๊ฐ€๋ฒ•๋ น์ •๋ณด์„ผํ„ฐ ์ œ๊ณต ๋ฒ•๋ น 99.9% ์ด์ƒ์„ ์ˆ˜๋กํ•˜๋ฉฐ, ๋งค์ฃผ ํ† ์š”์ผ ์ตœ์‹  ๋™๊ธฐํ™”ํ•ฉ๋‹ˆ๋‹ค.
  2. XML, HWP, PDF๋ฅผ ์‚ฌ์ „ ํŒŒ์‹ฑํ•˜์—ฌ ํ‘œ ๋ฐ์ดํ„ฐ๋ฅผ ํฌํ•จํ•œ ๋ชจ๋“  ์ถœ๋ ฅ์„ JSON์œผ๋กœ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  3. PostgreSQL๊ณผ ๋ฒกํ„ฐ ๊ฒ€์ƒ‰ ์—”์ง„์„ ์‚ฌ์šฉํ•˜๋ฉฐ, ์ฃผ์š” ์กฐ๋ฌธ ์•ฝ 20๋งŒ๊ฑด์˜ ์˜๋ฏธ ๊ธฐ๋ฐ˜ ๊ฒ€์ƒ‰์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
  4. ์ธ์ฆํ‚ค ์—†์ด ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ REST API์ด๋ฉฐ, ๋ถ„๋‹น 100ํšŒ ์ œํ•œ์ด ์žˆ์Šต๋‹ˆ๋‹ค. 500 ๋™์‹œ์ ‘์† ์ŠคํŠธ๋ ˆ์Šค ํ…Œ์ŠคํŠธ๋ฅผ ์™„๋ฃŒํ•˜์˜€์Šต๋‹ˆ๋‹ค.
  5. ๋กœ๊ทธ์ธ, IP, ์ฟผ๋ฆฌ ๋“ฑ์„ ๋กœ๊น…ํ•˜์ง€ ์•Š์œผ๋ฉฐ, ์ต๋ช… ์—”๋“œํฌ์ธํŠธ ํ˜ธ์ถœ ๋นˆ๋„๋งŒ ์ง‘๊ณ„ํ•ฉ๋‹ˆ๋‹ค.
  6. ๋ฌด๋ฃŒ์ด๋ฉฐ ์ˆ˜์ตํ™” ๊ณ„ํš์ด ์—†์Šต๋‹ˆ๋‹ค.

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