giip
SES Proposal
2 min read

ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ ๋ชฉ๋ก ๊ฐ€์ด๋“œ

ํ”„๋กœ์ ํŠธ(CSN) ๋‹จ์œ„๋กœ ๋“ฑ๋ก๋œ ๋ฉ”๋ชจ๋ฅผ ์กฐํšŒยทํƒœ๊ทธ ํ•„ํ„ฐ๋งยท์ˆ˜์ •ยท์‚ญ์ œํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.

๐Ÿš€ ๋ฉ”๋ชจ ๋ชฉ๋ก ํŽ˜์ด์ง€๋กœ ์ด๋™ โ†’

๐Ÿ“‹ ๊ฐœ์š”

ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ ๋ชฉ๋ก์€ ํŠน์ • ํ”„๋กœ์ ํŠธ(CSN)์— ์†ํ•œ ๋ฉ”๋ชจ๋ฅผ ํ•œ ํ™”๋ฉด์—์„œ ๊ด€๋ฆฌํ•˜๋Š” ํŽ˜์ด์ง€์ž…๋‹ˆ๋‹ค. ์ƒ๋‹จ์—์„œ ํ”„๋กœ์ ํŠธ ์ฝ”๋“œ(CSN)๋ฅผ ์ง€์ •ํ•ด ์กฐํšŒํ•˜๊ณ , ํƒœ๊ทธ๋กœ ๊ฑธ๋Ÿฌ ๋ณด๋ฉฐ, ๊ฐ ๋ฉ”๋ชจ๋ฅผ ๋ฐ”๋กœ ์ˆ˜์ •ํ•˜๊ฑฐ๋‚˜ ์‚ญ์ œํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋กœ๊ทธ์ธ์ด ํ•„์š”ํ•œ ํŽ˜์ด์ง€์ž…๋‹ˆ๋‹ค.

๐Ÿ” ์ฃผ์š” ๊ธฐ๋Šฅ ์„ค๋ช…

1. ํ”„๋กœ์ ํŠธ(CSN) ์ง€์ • ์กฐํšŒ

์ƒ๋‹จ์˜ ํ”„๋กœ์ ํŠธ(CSN) ์ž…๋ ฅ๋ž€์— ํ”„๋กœ์ ํŠธ ์ฝ”๋“œ๋ฅผ ๋„ฃ๊ณ  [Fetch] ๋ฒ„ํŠผ์„ ๋ˆ„๋ฅด๋ฉด ํ•ด๋‹น ํ”„๋กœ์ ํŠธ์˜ ๋ฉ”๋ชจ๊ฐ€ ์กฐํšŒ๋ฉ๋‹ˆ๋‹ค. ํŽ˜์ด์ง€ ์ง„์ž… ์‹œ URL์˜ ?csn= ํŒŒ๋ผ๋ฏธํ„ฐ ๋˜๋Š” ํ˜„์žฌ ์„ธ์…˜์˜ ํ”„๋กœ์ ํŠธ๊ฐ€ ์ž๋™์œผ๋กœ ์ฑ„์›Œ์ง‘๋‹ˆ๋‹ค.

2. ์„ธ์…˜ ํ”„๋กœ์ ํŠธ ์—ฐ๋™

ํ™”๋ฉด ์ƒ๋‹จ ๊ณตํ†ต ์˜์—ญ์˜ ํ”„๋กœ์ ํŠธ ํ’€๋‹ค์šด์„ ๋ฐ”๊พธ๋ฉด, ๋ชฉ๋ก๋„ ์ƒˆ ํ”„๋กœ์ ํŠธ ๊ธฐ์ค€์œผ๋กœ ์ž๋™ ์ƒˆ๋กœ๊ณ ์นจ๋˜๊ณ  URL์˜ csn ๊ฐ’๋„ ํ•จ๊ป˜ ๊ฐฑ์‹ ๋ฉ๋‹ˆ๋‹ค. ๋‹ค๋ฅธ ํƒญ์—์„œ ํ”„๋กœ์ ํŠธ๋ฅผ ๋ณ€๊ฒฝํ•œ ๊ฒฝ์šฐ์—๋„ ๋ชฉ๋ก์— ๋ฐ˜์˜๋ฉ๋‹ˆ๋‹ค.

3. ๋ฉ”๋ชจ ๋ชฉ๋ก ํ‘œ์‹œ (ํ…Œ์ด๋ธ” / ์นด๋“œ)

์กฐํšŒ ๊ฒฐ๊ณผ๋Š” ๋ฐ์Šคํฌํ†ฑ์—์„œ๋Š” ํ‘œ(ํ…Œ์ด๋ธ”), ๋ชจ๋ฐ”์ผ์—์„œ๋Š” ์นด๋“œ ํ˜•ํƒœ๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. ๊ฐ ๋ฉ”๋ชจ์˜ ์ด๋ฆ„(cmName), ๋‚ด์šฉ(cmVal), ํƒœ๊ทธ(tags) ๋“ฑ ๊ฒฐ๊ณผ์— ํฌํ•จ๋œ ์ปฌ๋Ÿผ์ด ๊ทธ๋Œ€๋กœ ๋…ธ์ถœ๋ฉ๋‹ˆ๋‹ค.

  • URL ์ž๋™ ๋งํฌ: ๋ฉ”๋ชจ ๋‚ด์šฉ(cmVal)์ด http(s)://๋กœ ์‹œ์ž‘ํ•˜๋ฉด ์ƒˆ ํƒญ์—์„œ ์—ด๋ฆฌ๋Š” ๋งํฌ๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.
  • ํƒœ๊ทธ ๋ฐฐ์ง€: ํƒœ๊ทธ ์ปฌ๋Ÿผ์€ ์‰ผํ‘œ๋กœ ๊ตฌ๋ถ„ํ•ด ๋ฐฐ์ง€ ํ˜•ํƒœ๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

4. ํƒœ๊ทธ ํ•„ํ„ฐ

๊ฒฐ๊ณผ์— ํƒœ๊ทธ๊ฐ€ ์žˆ์œผ๋ฉด ์ƒ๋‹จ์— ํƒœ๊ทธ ํ•„ํ„ฐ ๋ฒ„ํŠผ์ด ๋‚˜ํƒ€๋‚ฉ๋‹ˆ๋‹ค. **[์ „์ฒด]**๋ฅผ ๋ˆ„๋ฅด๋ฉด ๋ชจ๋“  ๋ฉ”๋ชจ๊ฐ€, ํŠน์ • ํƒœ๊ทธ๋ฅผ ๋ˆ„๋ฅด๋ฉด ํ•ด๋‹น ํƒœ๊ทธ๊ฐ€ ๋‹ฌ๋ฆฐ ๋ฉ”๋ชจ๋งŒ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

5. ๋ฉ”๋ชจ ์ถ”๊ฐ€ / ์ˆ˜์ • / ์‚ญ์ œ

  • ์ถ”๊ฐ€: ์ƒ๋‹จ [Add Memo] ๋ฒ„ํŠผ์„ ๋ˆ„๋ฅด๋ฉด ํ˜„์žฌ CSN์„ ๊ฐ€์ง€๊ณ  ๋ฉ”๋ชจ ์ถ”๊ฐ€ ํŽ˜์ด์ง€(corpMemoPut)๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.
  • ์ˆ˜์ •: ๊ฐ ํ–‰์˜ ์—ฐํ•„ ์•„์ด์ฝ˜์„ ๋ˆ„๋ฅด๋ฉด ํ•ด๋‹น ๋ฉ”๋ชจ(cmSn, cmName)๋ฅผ ๋ถˆ๋Ÿฌ์˜จ ์ƒํƒœ๋กœ ํŽธ์ง‘ ํŽ˜์ด์ง€๊ฐ€ ์—ด๋ฆฝ๋‹ˆ๋‹ค.
  • ์‚ญ์ œ: ๊ฐ ํ–‰์˜ ํœด์ง€ํ†ต ์•„์ด์ฝ˜์„ ๋ˆ„๋ฅด๋ฉด ํ™•์ธ์ฐฝ์ด ๋œจ๊ณ , ํ™•์ธ ์‹œ ๋ฉ”๋ชจ๊ฐ€ ์‚ญ์ œ๋œ ๋’ค ๋ชฉ๋ก์ด ๋‹ค์‹œ ์กฐํšŒ๋ฉ๋‹ˆ๋‹ค. ์‚ญ์ œ๋Š” ๋˜๋Œ๋ฆด ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค.

๐Ÿ› ๏ธ ํ™œ์šฉ ํŒ

  • ๋ฉ”๋ชจ ์ถ”๊ฐ€/์ˆ˜์ • ํŽ˜์ด์ง€์—์„œ ํƒœ๊ทธ ์ž…๋ ฅ๋ž€์— ๊ฐ’์„ ์ž…๋ ฅํ•œ ๋’ค ์‰ผํ‘œ(,) ๋˜๋Š” Enter๋ฅผ ๋ˆ„๋ฅด๋ฉด ํƒœ๊ทธ๊ฐ€ ๋ฐฐ์ง€๋กœ ์ถ”๊ฐ€๋ฉ๋‹ˆ๋‹ค.
  • ๋ฉ”๋ชจ ๋‚ด์šฉ์— ์ฐธ๊ณ  URL์„ ๋„ฃ์œผ๋ฉด ๋ชฉ๋ก์—์„œ ๋ฐ”๋กœ ํด๋ฆญํ•  ์ˆ˜ ์žˆ์–ด ๋งํฌ ์ €์žฅ์†Œ์ฒ˜๋Ÿผ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ’ก ์œ ์˜ ์‚ฌํ•ญ

  • CSN์ด ๋น„์–ด ์žˆ์œผ๋ฉด ์กฐํšŒ ๊ฒฐ๊ณผ๊ฐ€ ํ‘œ์‹œ๋˜์ง€ ์•Š์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ”„๋กœ์ ํŠธ ์ฝ”๋“œ๋ฅผ ๋จผ์ € ์ง€์ •ํ•˜์„ธ์š”.
  • ์‚ญ์ œ๋Š” ํ™•์ธ ํ›„ ์ฆ‰์‹œ ๋ฐ˜์˜๋˜๋ฉฐ ๋ณต๊ตฌํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค.

API ์ฐธ์กฐ

์ด ํ™”๋ฉด์€ giip Azure ์ปค๋งจ๋“œ(corpMemoList ์กฐํšŒ, corpMemoPut ์ €์žฅ, corpMemoDel ์‚ญ์ œ)๋ฅผ ํ˜ธ์ถœํ•ด ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค. ์ƒ์„ธ ์‚ฌ์–‘์€ ๋ณ„๋„ ๊ฐ€์ด๋“œ๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

๐Ÿ“˜ API ๋ ˆํผ๋Ÿฐ์Šค ๊ฐœ์š”

๋ฌธ์ œ ํ•ด๊ฒฐ

์ฆ์ƒ์›์ธํ•ด๊ฒฐ
๋ฉ”๋ชจ๊ฐ€ ์กฐํšŒ๋˜์ง€ ์•Š์ŒCSN(ํ”„๋กœ์ ํŠธ ์ฝ”๋“œ)์ด ๋น„์–ด ์žˆ๊ฑฐ๋‚˜ ์ž˜๋ชป๋จ์ƒ๋‹จ ์ž…๋ ฅ๋ž€์— ์˜ฌ๋ฐ”๋ฅธ CSN์„ ๋„ฃ๊ณ  [Fetch]๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
ํƒœ๊ทธ ํ•„ํ„ฐ ๋ฒ„ํŠผ์ด ์•ˆ ๋ณด์ž„์กฐํšŒ ๊ฒฐ๊ณผ์— ํƒœ๊ทธ(tags) ์ปฌ๋Ÿผ/๊ฐ’์ด ์—†์Œํƒœ๊ทธ๊ฐ€ ํฌํ•จ๋œ ๋ฉ”๋ชจ๋ฅผ ๋“ฑ๋กํ•˜๋ฉด ํ•„ํ„ฐ๊ฐ€ ๋‚˜ํƒ€๋‚ฉ๋‹ˆ๋‹ค.
์‚ญ์ œ๊ฐ€ ์‹คํŒจํ•จ๊ฒฐ๊ณผ์— cmSn ์ปฌ๋Ÿผ/๊ฐ’์ด ์—†๊ฑฐ๋‚˜ ์„ธ์…˜์ด ๋งŒ๋ฃŒ๋จ๋ชฉ๋ก์„ ๋‹ค์‹œ ์กฐํšŒํ•˜๊ฑฐ๋‚˜ ๋‹ค์‹œ ๋กœ๊ทธ์ธ ํ›„ ์žฌ์‹œ๋„ํ•ฉ๋‹ˆ๋‹ค.
ํ”„๋กœ์ ํŠธ๋ฅผ ๋ฐ”๊ฟ”๋„ ๋ชฉ๋ก์ด ๊ทธ๋Œ€๋กœ์ž„์„ธ์…˜ ๋ณ€๊ฒฝ ์ด๋ฒคํŠธ๊ฐ€ ๋ฐ˜์˜๋˜์ง€ ์•Š์Œ์ƒ๋‹จ [Fetch]๋ฅผ ๋ˆŒ๋Ÿฌ ์ˆ˜๋™ ์ƒˆ๋กœ๊ณ ์นจํ•˜๊ฑฐ๋‚˜ ํŽ˜์ด์ง€๋ฅผ ์ƒˆ๋กœ๊ณ ์นจํ•ฉ๋‹ˆ๋‹ค.

๋ฒ„์ „: 1.0 ์ตœ์ข… ์—…๋ฐ์ดํŠธ: 2026-07-22 ์†Œ์Šค ํŒŒ์ผ: giipv3/public/help/corpmemolist.ko.md