Skip to Content
KPIS DSR API์‚ฌ์šฉ์ž ๋งค๋‰ด์–ผ๋‚ด๋ณด๋‚ด๊ธฐ ๋ฐ ์ œ์ถœ

๋‚ด๋ณด๋‚ด๊ธฐ ๋ฐ ์ œ์ถœ

๊ฒ€์ฆ์„ ๋งˆ์นœ ๊ณต๊ธ‰๋‚ด์—ญ ๋ฐ์ดํ„ฐ๋ฅผ KPIS์— ์ œ์ถœํ•˜๋Š” ๋‘ ๊ฐ€์ง€ ๋ฐฉ๋ฒ•(์ˆ˜๋™๋ณด๊ณ /์ž๋™๋ณด๊ณ )๊ณผ ๋ฐ˜์†ก ์ฒ˜๋ฆฌ ์ ˆ์ฐจ๋ฅผ ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.

์ˆ˜๋™๋ณด๊ณ : ์—‘์…€ ๋‚ด๋ณด๋‚ด๊ธฐ

KPIS ํฌํ„ธ์— ์ง์ ‘ ์—…๋กœ๋“œํ•˜๋ ค๋Š” ๊ฒฝ์šฐ, ๊ฐ€๊ณต๋œ ๋ฐ์ดํ„ฐ๋ฅผ ์—‘์…€ ํŒŒ์ผ๋กœ ๋‚ด๋ณด๋ƒ…๋‹ˆ๋‹ค.

๋‚ด๋ณด๋‚ด๊ธฐ ์ ˆ์ฐจ

  1. ๋ฐ์ดํ„ฐ ํŽธ์ง‘ ํ™”๋ฉด์—์„œ ๋‚ด๋ณด๋‚ด๊ธฐ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  2. ๋‚ด๋ณด๋‚ด๊ธฐ ๋ฒ”์œ„๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
    • ํ˜„์žฌ ํƒญ๋งŒ: ์„ ํƒํ•œ ๊ณต๊ธ‰๊ตฌ๋ถ„(์ถœ๊ณ /๋ฐ˜ํ’ˆ/ํ๊ธฐ/์ •์ •/์ทจ์†Œ)์˜ ๋ฐ์ดํ„ฐ๋งŒ ๋‚ด๋ณด๋‚ด๊ธฐ
    • ์ „์ฒด: ๋ชจ๋“  ๊ณต๊ธ‰๊ตฌ๋ถ„์˜ ๋ฐ์ดํ„ฐ๋ฅผ ํ•œ ํŒŒ์ผ์— ๋‚ด๋ณด๋‚ด๊ธฐ
  3. ๊ฐ‘์ง€์™€ ์„์ง€๊ฐ€ ๊ฐ๊ฐ ๋ณ„๋„ ์‹œํŠธ ๋˜๋Š” ๋ณ„๋„ ํŒŒ์ผ๋กœ ์ƒ์„ฑ๋ฉ๋‹ˆ๋‹ค.
  4. ๋ธŒ๋ผ์šฐ์ €์˜ ๋‹ค์šด๋กœ๋“œ ํด๋”์— .xlsx ํŒŒ์ผ์ด ์ €์žฅ๋ฉ๋‹ˆ๋‹ค.

๋‚ด๋ณด๋‚ด๊ธฐ ํŒŒ์ผ ๊ตฌ์„ฑ

ํ•ญ๋ชฉ์„ค๋ช…
ํŒŒ์ผ ํ˜•์‹.xlsx (Excel 2007 ์ด์ƒ)
๊ฐ‘์ง€21์—ด, ํ—ค๋” ์—†์Œ โ€” KPIS ์—…๋กœ๋“œ ์–‘์‹๊ณผ ๋™์ผ
์„์ง€3์—ด, ํ—ค๋” ์—†์Œ โ€” ๊ฐ‘์ง€ ์—ฐ๋ฒˆ๊ณผ ๋งค์นญ

๋‚ด๋ณด๋‚ด๊ธฐ๋Š” ์ˆœ์ˆ˜ ์ฝ๊ธฐ ์ž‘์—…์ž…๋‹ˆ๋‹ค. DB์— ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ์— ์˜ํ–ฅ์„ ์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

KPIS ํฌํ„ธ ์—…๋กœ๋“œ

๋‚ด๋ณด๋‚ธ ์—‘์…€ ํŒŒ์ผ์„ KPIS ํฌํ„ธ(https://www.kpis.or.kr)์—ย  ์ง์ ‘ ์—…๋กœ๋“œํ•˜๋Š” ์ ˆ์ฐจ์ž…๋‹ˆ๋‹ค.

  1. KPIS ํฌํ„ธ์— ๊ณต๋™์ธ์ฆ์„œ๋กœ ๋กœ๊ทธ์ธํ•ฉ๋‹ˆ๋‹ค.
  2. ๊ณต๊ธ‰๋‚ด์—ญ ๋ณด๊ณ  ๋ฉ”๋‰ด์—์„œ ์—‘์…€ ์—…๋กœ๋“œ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  3. ๊ฐ‘์ง€ ํŒŒ์ผ๊ณผ ์„์ง€ ํŒŒ์ผ์„ ๊ฐ๊ฐ ์—…๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค.
  4. ์ œ์ถœ ํ›„ ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์ž๋™๋ณด๊ณ : MA111 API ์ œ์ถœ

์‹œ์Šคํ…œ์—์„œ KPIS API๋ฅผ ํ†ตํ•ด ์ง์ ‘ ์ œ์ถœํ•˜๋Š” ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค. ์ˆ˜๋™ ์—…๋กœ๋“œ ์—†์ด ๋ฒ„ํŠผ ํด๋ฆญ์œผ๋กœ ์™„๋ฃŒ๋ฉ๋‹ˆ๋‹ค.

์‚ฌ์ „ ์กฐ๊ฑด

์ž๋™๋ณด๊ณ ๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ๋‹ค์Œ์ด ์„ค์ •๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์กฐ๊ฑด์„ค๋ช…์„ค์ • ์œ„์น˜
API ์„ค์ •์‚ฌ์—…์ž๋“ฑ๋ก๋ฒˆํ˜ธ, API KEY ๋“ฑ๋ก๊ด€๋ฆฌ์ž > API ์„ค์ •
๊ณต๋™์ธ์ฆ์„œ์œ ํšจํ•œ .pfx ์ธ์ฆ์„œ ์—…๋กœ๋“œ๊ด€๋ฆฌ์ž > ์ธ์ฆ์„œ ๊ด€๋ฆฌ
์œ ํšจ์„ฑ ๊ฒ€์ฆ ํ†ต๊ณผ์˜ค๋ฅ˜ 0๊ฑด๋ฐ์ดํ„ฐ ํŽธ์ง‘ ํ™”๋ฉด
์‚ฌ์šฉ์ž ์Šน์ธ๊ด€๋ฆฌ์ž๊ฐ€ ์Šน์ธํ•œ ๊ณ„์ •๊ด€๋ฆฌ์ž > ์‚ฌ์šฉ์ž ๊ด€๋ฆฌ

๊ณต๋™์ธ์ฆ์„œ๊ฐ€ ๋งŒ๋ฃŒ๋˜์—ˆ๊ฑฐ๋‚˜ ๋ฏธ๋“ฑ๋ก์ด๋ฉด ์ „์†ก ๋ฒ„ํŠผ์ด ๋น„ํ™œ์„ฑํ™”๋ฉ๋‹ˆ๋‹ค.

์ œ์ถœ ์ ˆ์ฐจ

  1. ๋ฐ์ดํ„ฐ ํŽธ์ง‘ ํ™”๋ฉด์—์„œ ์œ ํšจ์„ฑ ๊ฒ€์ฆ์ด ํ†ต๊ณผ๋˜์—ˆ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค (์˜ค๋ฅ˜ 0๊ฑด).
  2. API ์ œ์ถœ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  3. ์‹œ์Šคํ…œ์ด MA111(๊ณต๊ธ‰๋‚ด์—ญ ์ •๋ณด ์ง์ ‘ ๋“ฑ๋ก) API๋ฅผ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.
    • ์„œ๋ฒ„๊ฐ€ DB์—์„œ ๊ณต๋™์ธ์ฆ์„œ๋ฅผ ๋กœ๋“œํ•˜๊ณ  ๋ณตํ˜ธํ™”ํ•ฉ๋‹ˆ๋‹ค.
    • SOAP XML์„ ์ƒ์„ฑํ•˜๊ณ  WS-Security ์ „์ž์„œ๋ช…์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
    • KPIS ์šด์˜ ์„œ๋ฒ„์— ๋ฐ์ดํ„ฐ๋ฅผ ์ „์†กํ•ฉ๋‹ˆ๋‹ค.
  4. ์ ‘์ˆ˜๊ฐ€ ์™„๋ฃŒ๋˜๋ฉด ๊ฐ ํ–‰์— ์ ‘์ˆ˜๋ฒˆํ˜ธ(rcptNo)๊ฐ€ ๋ถ€์—ฌ๋ฉ๋‹ˆ๋‹ค.

MA112 ๊ฒฐ๊ณผ ํ™•์ธ

MA111๋กœ ์ œ์ถœํ•œ ๋ฐ์ดํ„ฐ์˜ ์ฒ˜๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

  1. ์ œ์ถœ ์™„๋ฃŒ ํ›„ ๊ฒฐ๊ณผ ํ™•์ธ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  2. ์‹œ์Šคํ…œ์ด MA112(๊ณต๊ธ‰๋‚ด์—ญ ๋“ฑ๋ก ๊ฒฐ๊ณผ ์กฐํšŒ) API๋ฅผ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.
  3. ๊ฐ ๊ฑด๋ณ„๋กœ ์ฒ˜๋ฆฌ ์ƒํƒœ๊ฐ€ ์—…๋ฐ์ดํŠธ๋ฉ๋‹ˆ๋‹ค.
์ƒํƒœ์˜๋ฏธํ‘œ์‹œ
submitted์ ‘์ˆ˜ ์™„๋ฃŒ, ์ฒ˜๋ฆฌ ๋Œ€๊ธฐํŒŒ๋ž€์ƒ‰
registered๋“ฑ๋ก ์™„๋ฃŒ์ดˆ๋ก์ƒ‰
returned๋ฐ˜์†ก โ€” ์ˆ˜์ • ํ•„์š”๋นจ๊ฐ„์ƒ‰

KPIS ์„œ๋ฒ„์˜ ์ฒ˜๋ฆฌ ์‹œ๊ฐ„์— ๋”ฐ๋ผ ๊ฒฐ๊ณผ ์กฐํšŒ๊นŒ์ง€ ์‹œ๊ฐ„์ด ์†Œ์š”๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ ‘์ˆ˜ ์งํ›„์—๋Š” submitted ์ƒํƒœ์ด๋ฉฐ, ์ผ์ • ์‹œ๊ฐ„ ํ›„ registered ๋˜๋Š” returned๋กœ ๋ณ€๊ฒฝ๋ฉ๋‹ˆ๋‹ค.

๋ฐ˜์†ก ์ฒ˜๋ฆฌ

MA112 ๊ฒฐ๊ณผ์—์„œ ๋ฐ˜์†ก(returned)๋œ ๊ฑด์€ ์›์ธ์„ ํ™•์ธํ•˜๊ณ  ์ˆ˜์ •ํ•œ ํ›„ ๋‹ค์‹œ ์ œ์ถœํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

๋ฐ˜์†ก์ฝ”๋“œ (DC001~DC007)

์ฝ”๋“œ์‚ฌ์œ ์›์ธ๋Œ€์‘ ๋ฐฉ๋ฒ•
DC001ํ‘œ์ค€์ฝ”๋“œ ๋ถˆ์ผ์น˜์กด์žฌํ•˜์ง€ ์•Š๊ฑฐ๋‚˜ ๋งŒ๋ฃŒ๋œ ํ‘œ์ค€์ฝ”๋“œMA101๋กœ ์ •ํ™•ํ•œ ํ‘œ์ค€์ฝ”๋“œ ์žฌ๊ฒ€์ฆ ํ›„ ์ˆ˜์ •
DC002๋ฏธ๋“ฑ๋ก ๊ฑฐ๋ž˜์ฒ˜KPIS์— ๋“ฑ๋ก๋˜์ง€ ์•Š์€ ๊ฑฐ๋ž˜์ฒ˜MA102๋กœ ๊ฑฐ๋ž˜์ฒ˜ ๋“ฑ๋ก์—ฌ๋ถ€ ํ™•์ธ ํ›„ ์‚ฌ์—…์ž๋ฒˆํ˜ธ ์ˆ˜์ •
DC003๋ณด๊ณ ๊ธฐ๊ฐ„ ์™ธ ๊ณต๊ธ‰์ผ์žํ•ด๋‹น ๋ถ„๊ธฐ ๋ณด๊ณ ๊ธฐ๊ฐ„์— ๋งž์ง€ ์•Š๋Š” ๋‚ ์งœMA116์œผ๋กœ ๋ถ„๊ธฐ ๋ณด๊ณ ๊ธฐ๊ฐ„ ํ™•์ธ ํ›„ ๊ณต๊ธ‰์ผ์ž ์ˆ˜์ •
DC004์ค‘๋ณต๋ณด๊ณ ๋™์ผ ๋ฐ์ดํ„ฐ๊ฐ€ ์ด๋ฏธ ๋“ฑ๋ก๋จMA112๋กœ ๊ธฐ๋“ฑ๋ก ์ ‘์ˆ˜๋ฒˆํ˜ธ ํ™•์ธ ํ›„ ์ •์ •(4) ๋˜๋Š” ์ทจ์†Œ(5) ์ฒ˜๋ฆฌ
DC005์ˆ˜๋Ÿ‰/๊ธˆ์•ก ์˜ค๋ฅ˜๋‹จ๊ฐ€ x ์ˆ˜๋Ÿ‰ โ‰  ๊ธˆ์•ก๋‹จ๊ฐ€, ์ˆ˜๋Ÿ‰, ๊ธˆ์•ก ์ •ํ•ฉ์„ฑ ํ™•์ธ ํ›„ ์ˆ˜์ •
DC006์„์ง€ ๋ˆ„๋ฝ์ผ๋ จ๋ฒˆํ˜ธ๊ตฌ๋ถ„=0์ธ๋ฐ ์„์ง€ ๋ฐ์ดํ„ฐ ์—†์Œ์„์ง€ ํŒŒ์ผ ์žฌ์—…๋กœ๋“œ ๋˜๋Š” ์ผ๋ จ๋ฒˆํ˜ธ๊ตฌ๋ถ„ ๋ณ€๊ฒฝ
DC007์š”์–‘๊ธฐ๊ด€๊ธฐํ˜ธ ์˜ค๋ฅ˜๊ณต๊ธ‰ํ˜•ํƒœ=9(์š”์–‘๊ธฐ๊ด€)์ธ๋ฐ ๊ธฐ๊ด€๊ธฐํ˜ธ ๋ˆ„๋ฝ/์˜ค๋ฅ˜8์ž๋ฆฌ ์š”์–‘๊ธฐ๊ด€๊ธฐํ˜ธ ํ™•์ธ ํ›„ ์ˆ˜์ •

์˜ค๋ฅ˜์ฝ”๋“œ์™€ ๋ฐ˜์†ก์ฝ”๋“œ์˜ ์ฐจ์ด

๊ตฌ๋ถ„์˜ค๋ฅ˜์ฝ”๋“œ๋ฐ˜์†ก์ฝ”๋“œ
๋ฐœ์ƒ ์‹œ์ API ํ˜ธ์ถœ ์ž์ฒด ์‹คํŒจ์ ‘์ˆ˜๋Š” ๋์ง€๋งŒ ๊ฒ€์ฆ ์‹คํŒจ
์›์ธ๋„คํŠธ์›Œํฌ, ์ธ์ฆ, ์š”์ฒญ ํ˜•์‹๋ฐ์ดํ„ฐ ๋‚ด์šฉ ๋ฌธ์ œ
๋Œ€์‘์ธ์ฆ์„œ/๋„คํŠธ์›Œํฌ ํ™•์ธ๋ฐ์ดํ„ฐ ์ˆ˜์ • ํ›„ ์žฌ์ œ์ถœ

MA113 ์žฌ์‹ ์ฒญ ์ ˆ์ฐจ

๋ฐ˜์†ก๋œ ๊ฑด์„ ์ˆ˜์ •ํ•œ ํ›„ ์žฌ์ œ์ถœํ•˜๋Š” ์ ˆ์ฐจ์ž…๋‹ˆ๋‹ค.

  1. MA112 ๊ฒฐ๊ณผ์—์„œ ๋ฐ˜์†ก(returned) ๊ฑด์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  2. ๋ฐ˜์†ก์ฝ”๋“œ(DC์ฝ”๋“œ)๋ฅผ ํ™•์ธํ•˜๊ณ  ํ•ด๋‹น ๋ฐ์ดํ„ฐ๋ฅผ ์ˆ˜์ •ํ•ฉ๋‹ˆ๋‹ค.
  3. ๋ฐ˜์†ก์‹ ์ฒญ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  4. ์‹œ์Šคํ…œ์ด MA113(๋ฐ˜์†ก์‹ ์ฒญ ์ง์ ‘ ๋“ฑ๋ก) API๋ฅผ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.
  5. ์ ‘์ˆ˜ ์™„๋ฃŒ ํ›„ MA114(๋ฐ˜์†ก์š”์ฒญ ๋“ฑ๋ก ๊ฒฐ๊ณผ ์กฐํšŒ)๋กœ ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์žฌ์‹ ์ฒญ ์‹œ ์ฃผ์˜์‚ฌํ•ญ

  • ๋ฐ˜์†ก์‹ ์ฒญ์€ ๋ฐ˜๋“œ์‹œ ์›๋ž˜ ์ ‘์ˆ˜๋ฒˆํ˜ธ๋ฅผ ํฌํ•จํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฐ˜์†ก ์‚ฌ์œ ์— ๋งž๋Š” ํ•„๋“œ๋งŒ ์ˆ˜์ •ํ•ฉ๋‹ˆ๋‹ค. ๋ถˆํ•„์š”ํ•œ ํ•„๋“œ ๋ณ€๊ฒฝ์€ ์ถ”๊ฐ€ ๋ฐ˜์†ก์˜ ์›์ธ์ด ๋ฉ๋‹ˆ๋‹ค.
  • DC004(์ค‘๋ณต๋ณด๊ณ )์˜ ๊ฒฝ์šฐ ์žฌ์‹ ์ฒญ์ด ์•„๋‹Œ ์ •์ •(์ฝ”๋“œ 4) ๋˜๋Š” ์ทจ์†Œ(์ฝ”๋“œ 5)๋กœ ์ฒ˜๋ฆฌํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ œ์ถœ ์ƒํƒœ ์š”์•ฝ

์ „์ฒด ๋ฐ์ดํ„ฐ์˜ ์ œ์ถœ ํ˜„ํ™ฉ์€ ์‚ฌ์ด๋“œ๋ฐ”์˜ ๋‹ฌ๋ ฅ์—์„œ ๋‚ ์งœ๋ณ„๋กœ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋‹ฌ๋ ฅ ์ƒํƒœ์˜๋ฏธ
done (์ดˆ๋ก์ƒ‰)ํ•ด๋‹น ๋‚ ์งœ์˜ ๋ชจ๋“  ๊ฑด์ด ๋“ฑ๋ก ์™„๋ฃŒ
partial (๋…ธ๋ž€์ƒ‰)์ผ๋ถ€ ๋ฏธ์ œ์ถœ ๋˜๋Š” ๋ฐ˜์†ก ๊ฑด ์กด์žฌ
missing (๋นจ๊ฐ„์ƒ‰)๋ฐ์ดํ„ฐ ์—†์Œ (๋ฏธ๋ณด๊ณ )
ignored (ํšŒ์ƒ‰)๋ฏธ๋ณด๊ณ  ๋ฌด์‹œ ์ฒ˜๋ฆฌ๋จ

๋‹ค์Œ ๋‹จ๊ณ„