API ๋ฌธ์„œ

์ „์ฒด API

์„œ๋น„์Šค


โ€‹

ํœด๋ฉด ํšŒ์› ํ•ด์ œ๋™๊ธฐ

๋ฒ„์ „: v1


๋ฒ„์ „: v1

POST

/api/v1/user/dormancy/change-active

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

์‘๋‹ต ํ—ค๋”


X-KM-Correlation-Id

string

ํ•„์ˆ˜

๊ธธ์ด : 20

์ „๋ฌธ ์ถ”์ ์„ ์œ„ํ•œ ๊ฑฐ๋ž˜๋ฒˆํ˜ธ

  • ํ˜•์‹ : yyMMddHHmiSS-xxxxxxx
  • xxxxxxx : 7์ž๋ฆฌ, Hex String

X-KM-Crypto-Key-Id

string

์˜ต์…˜

๊ธธ์ด : 32

๋ฐ์ดํ„ฐ์•”๋ณตํ˜ธํ™” ํ‚ค ID

  • ์„œ๋น„์Šค ์‚ฌ์—…์ž์˜ ํ”„๋กœ์ ํŠธ์—์„œ ์ƒ์„ฑ ์‹œ ๋ถ€์—ฌํ•œ ID์ž…๋‹ˆ๋‹ค
  • Callback์œผ๋กœ ์ „๋‹ฌ๋  ๊ฒฝ์šฐ ์„œ๋น„์Šค ์‚ฌ์—…์ž์—๊ฒŒ ๋ฐœ๊ธ‰๋œ ํ‚ค ์ค‘ ๊ฐ€์žฅ ๋จผ์ € ๋ฐœ๊ธ‰๋œ ํ‚ค๋ฅผ ์‚ฌ์šฉ ํ•ฉ๋‹ˆ๋‹ค.

์‘๋‹ต ์ฝ”๋“œ

Detailed classification and addition of error for unseccessful withfrawal


200

์—๋Ÿฌ ์ฝ”๋“œ

000_000

๋ฉ”์‹œ์ง€

Success

์„ค๋ช…

์„ฑ๊ณต


400

์—๋Ÿฌ ์ฝ”๋“œ

001_006

๋ฉ”์‹œ์ง€

Wallet user not found

์„ค๋ช…

ํšŒ์› ์ •๋ณด ์—†๋Š” ํ…Œ์ŠคํŠธ - `CI` ์š”์ฒญ ์ •๋ณด์™€ ์ผ์น˜ํ•œ ํœด๋ฉด ํšŒ์› ์ •๋ณด ์—†๋Š” ๊ฒฝ์šฐ


400

์—๋Ÿฌ ์ฝ”๋“œ

001_080

๋ฉ”์‹œ์ง€

User is blocked forgiven data and asp configuration

์„ค๋ช…

๋ถ€์ • ์‚ฌ์šฉ์ž ๋“ฑ๋ก ํšŒ์› ํ…Œ์ŠคํŠธ


400

์—๋Ÿฌ ์ฝ”๋“œ

001_087

๋ฉ”์‹œ์ง€

Dormancy user not found.

์„ค๋ช…

ํœด๋ฉด ํšŒ์› ์กฐํšŒ๊ฐ€ ์•ˆ๋˜๋Š” ๊ฒฝ์šฐ ํ…Œ์ŠคํŠธ

ํ…Œ์ŠคํŠธ ๋ฐ์ดํ„ฐ

200 - ์„ฑ๊ณต ํ…Œ์ŠคํŠธ


200 - ์„ฑ๊ณต ํ…Œ์ŠคํŠธ
400 - ํšŒ์› ์ •๋ณด ์—†๋Š” ํ…Œ์ŠคํŠธ - `CI` ์š”์ฒญ ์ •๋ณด์™€ ์ผ์น˜ํ•œ ํœด๋ฉด ํšŒ์› ์ •๋ณด ์—†๋Š” ๊ฒฝ์šฐ
400 - ๋ถ€์ • ์‚ฌ์šฉ์ž ๋“ฑ๋ก ํšŒ์› ํ…Œ์ŠคํŠธ
400 - ํœด๋ฉด ํšŒ์› ์กฐํšŒ๊ฐ€ ์•ˆ๋˜๋Š” ๊ฒฝ์šฐ ํ…Œ์ŠคํŠธ
Loading ...

Request

Loading...

Response

Try It!์„ ํด๋ฆญํ•˜์—ฌ
์ž…๋ ฅํ•œ Request์˜ Response๋ฅผ ํ™•์ธํ•˜์„ธ์š”.


ํšŒ์› ๊ฐ€์ž…ํšŒ์› ์ •๋ณด ์กฐํšŒํšŒ์› ๋น„๋ฐ€๋ฒˆํ˜ธ ์žฌ์„ค์ • ๋ฐ ๋ณ€๊ฒฝํšŒ์› ์ •๋ณด ๋ณ€๊ฒฝํšŒ์› ํƒˆํ‡ดํšŒ์› ๋กœ๊ทธ์ธ ID ํ™•์ธํœด๋ฉด ํšŒ์› ํ•ด์ œ์•ฝ๊ด€ ๋ชฉ๋ก ์กฐํšŒ์•ฝ๊ด€ ๋™์˜ ๋ฐ ์ฒ ํšŒCI ๊ฐ’์œผ๋กœ ํšŒ์› ์ •๋ณด ์กฐํšŒํšŒ์› ๋กœ๊ทธ์ธ ID ์ค‘๋ณต ํ™•์ธํšŒ์› ๋น„๋ฐ€๋ฒˆํ˜ธ ๊ฒ€์ฆํšŒ์› ์ธ์ฆ ์ •๋ณด ์กฐํšŒ๊ธˆ์œต์‚ฌ ๋ชฉ๋ก ์กฐํšŒ๊ณ„์ขŒ ์˜ˆ๊ธˆ์ฃผ ์‹ค๋ช… ๊ฒ€์ฆARS ์ธ์ฆ ์ „ ์ธ์ฆ์ฝ”๋“œ ์ƒ์„ฑPG๋ฅผ ํ†ตํ•œ ์€ํ–‰ ๊ณ„์ขŒ ๋“ฑ๋ก๊ณ„์ขŒ ๋“ฑ๋ก ์ƒํƒœ ์กฐํšŒ๊ธฐ๋ช…ํ™” ๋ฐ ํ•œ๋„์ƒํ–ฅ(๊ฐœ์ธ)ํšŒ์› ๋“ฑ๋ก ๊ณ„์ขŒ ์กฐํšŒํšŒ์› ๊ณ„์ขŒ ์ •๋ณด ์กฐํšŒ์ž๋™์ถฉ์ „ ๊ณ„์ขŒ ๋“ฑ๋กํšŒ์› ๊ณ„์ขŒ ์‚ญ์ œ๊ณ„์ขŒ 1์› ์ธ์ฆ ์š”์ฒญ๊ณ„์ขŒ 1์› ์ธ์ฆ ์ฝ”๋“œ ๊ฒ€์ฆ์„ ๋ถˆ์นด๋“œ ๋ฐœ๊ธ‰ ๋ฐ ๋ฐฐ์†ก ์‹ ์ฒญ์นด๋“œ ์‹ ์ฒญ ์ทจ์†Œ์„ ๋ถˆ์นด๋“œ ์žฌ๋ฐœ๊ธ‰(๊ต์ฒด๋ฐœ๊ธ‰)๋งŒ๋ฃŒ ์˜ˆ์ • ์„ ๋ถˆ์นด๋“œ ์žฌ๋ฐœ๊ธ‰ ๊ฐฑ์‹ ์นด๋“œ ๋ฐฐ์†ก ์ƒํƒœ ์กฐํšŒ์‹ค๋ฌผ์นด๋“œ์™€ ์—ฐ๊ฒฐ ๊ฐ€๋Šฅํ•œ ๋ชจ๋ฐ”์ผ์นด๋“œ ์‹ ์ฒญ ์ •๋ณด ์กฐํšŒ์‹ค๋ฌผ์นด๋“œ ๋“ฑ๋ก๋ณด์œ ์นด๋“œ ์กฐํšŒ๋ฏธ๋“ฑ๋ก ์นด๋“œ ์กฐํšŒ์นด๋“œ ์ƒํƒœ ๋ณ€๊ฒฝ์นด๋“œ ํ๊ธฐ๊ธฐ๋ช…ํ™” ๋ฐ ํ•œ๋„์ƒํ–ฅ(๊ฐœ์ธ)๊ธฐ๋ช…ํ™” ๋ฐ ํ•œ๋„์ƒํ–ฅ(๋ฒ•์ธ)๋ฒ•์ธ ๊ธฐ๋ช…ํ™” ์—ฌ๋ถ€ ์กฐํšŒ์†Œ๋“๊ณต์ œ ์‹ ์ฒญ์นด๋“œ ์†Œ๋“๊ณต์ œ ์‹ ์ฒญ ์—ฌ๋ถ€ ์กฐํšŒ์นด๋“œ ๋งคํ•‘ ํšŒ์› ์กฐํšŒ์นด๋“œ ์ƒํ’ˆID๋กœ ์ƒํ’ˆ ์ •๋ณด ์กฐํšŒ์ฃผ์นด๋“œ ์„ค์ •์นด๋“œ์— ์—ฐ๊ฒฐ๋œ ๊ฐ€์ƒ๊ณ„์ขŒ ์กฐํšŒ์ง๋ถˆ์นด๋“œ ๋ฐœ๊ธ‰ ๋ฐ ๋ฐฐ์†ก ์‹ ์ฒญ์นด๋“œ ์‹ ์ฒญ ์ทจ์†Œ์นด๋“œ ๋ฐฐ์†ก ์ƒํƒœ ์กฐํšŒ์‹ค๋ฌผ์นด๋“œ ๋“ฑ๋ก๋ณด์œ ์นด๋“œ ์กฐํšŒ์นด๋“œ ์ƒํƒœ ๋ณ€๊ฒฝ์นด๋“œ ํ•œ๋„ ๋ณ€๊ฒฝ์นด๋“œ ํ๊ธฐ์†Œ๋“๊ณต์ œ ์‹ ์ฒญ์นด๋“œ ์†Œ๋“๊ณต์ œ ์‹ ์ฒญ ์—ฌ๋ถ€ ์กฐํšŒ์ฃผ์นด๋“œ ์„ค์ •์ผํšŒ์šฉ ํ† ํฐ ๋ฐœ๊ธ‰๊ณ„์ขŒ ์ถฉ์ „๊ณ„์ขŒ ์ถฉ์ „์ทจ์†Œ์ถฉ์ „ ๋ฐ ์ถฉ์ „์ทจ์†Œ ๊ฒฐ๊ณผ ํ™•์ธ๊ฑฐ๋ž˜๋‚ด์—ญ ํ™•์ธ๊ธฐ์ค€ ํ•˜ํ•œ ๋ฐ ์›”์ •์•ก ์ž๋™ ์ถฉ์ „ ํ™œ์„ฑํ™”๊ธฐ์ค€ ํ•˜ํ•œ ์ž๋™ ์ถฉ์ „ ๋“ฑ๋ก๊ธฐ์ค€ ํ•˜ํ•œ ๋ฐ ์›”์ •์•ก ์ž๋™ ์ถฉ์ „ ๋ชฉ๋ก ์กฐํšŒ๊ธฐ์ค€ ํ•˜ํ•œ ์ž๋™ ์ถฉ์ „ ์ˆ˜์ •์›” ์ •์•ก ์ž๋™ ์ถฉ์ „ ๋“ฑ๋ก์›” ์ •์•ก ์ž๋™ ์ถฉ์ „ ์ˆ˜์ •๊ธฐ์ค€ ํ•˜ํ•œ ๋ฐ ์›”์ •์•ก ์ž๋™ ์ถฉ์ „ ๋“ฑ๋ก ํ•ด์ œ๊ฒฐ์ œ ์‹œ ์ž๋™ ์ถฉ์ „ ๋“ฑ๋ก๊ฒฐ์ œ ์‹œ ์ž๋™ ์ถฉ์ „ ๋“ฑ๋ก ํ•ด์ œ๊ฒฐ์ œ ์‹œ ์ž๋™ ์ถฉ์ „ ๋ชฉ๋ก ์กฐํšŒ์ผํšŒ์šฉ ํ† ํฐ ๋ฐœ๊ธ‰ํ™˜๋ถˆ ์ˆ˜์ˆ˜๋ฃŒ ์กฐํšŒํ™˜๋ถˆํ™˜๋ถˆ ๊ฒฐ๊ณผ ํ™•์ธ์‹œ์Šคํ…œ ์ถฉ์ „(์˜ˆ์น˜๊ธˆ)์‹œ์Šคํ…œ ์ถฉ์ „ ์ทจ์†Œ(์˜ˆ์น˜๊ธˆ)์‹œ์Šคํ…œ ํ™˜๋ถˆ(์˜ˆ์น˜๊ธˆ)์‹œ์Šคํ…œ ๋ถ€๋ถ„ํ™˜๋ถˆ(์˜ˆ์น˜๊ธˆ)์‹ ์šฉ์นด๋“œ ์ถฉ์ „ ๊ฑฐ๋ž˜ ์ƒ์„ฑ์‹ ์šฉ์นด๋“œ ์ถฉ์ „ ์ทจ์†Œ ์š”์ฒญํŽธ์˜์  ์ถฉ์ „/์ถœ๊ธˆ ์š”์ฒญ์˜ˆ์น˜๊ธˆ ๋‚ด์—ญ ์กฐํšŒ์˜ˆ์น˜๊ธˆ ์ž”์•ก ์กฐํšŒ์ผํšŒ์šฉ ํ† ํฐ ๋ฐœ๊ธ‰๊ฒฐ์ œ๊ฒฐ์ œ์ทจ์†Œ๊ฒฐ์ œ ๋ง์ทจ์†Œ๊ฑฐ๋ž˜๋‚ด์—ญ ํ™•์ธํฌ์ธํŠธ ๊ฑฐ๋ž˜๋‚ด์—ญ ํ™•์ธ๋ณด์œ ์นด๋“œ ์กฐํšŒํฌ์ธํŠธ ์‚ฌ์šฉ์˜ˆ์•ฝ ๋ฐ ์ทจ์†Œํฌ์ธํŠธ ๊ฑฐ๋ž˜๋‚ด์—ญ ํ™•์ธ๊ด€๋ฆฌ์ž ํฌ์ธํŠธ ์ง€๊ธ‰๊ด€๋ฆฌ์ž ํฌ์ธํŠธ ํ™˜์ˆ˜์Šคํƒฌํ”„์นด๋“œ ์ ๋ฆฝ์ด๋ ฅ์กฐํšŒ๋ณด์œ  ์Šคํƒฌํ”„์นด๋“œ ๋ชฉ๋ก ์กฐํšŒ๋ณด์œ  ๋งˆ์ผ๋ฆฌ์ง€์นด๋“œ ๋ชฉ๋ก ์กฐํšŒ๋งˆ์ผ๋ฆฌ์ง€์นด๋“œ ์ ๋ฆฝ์ด๋ ฅ์กฐํšŒ์นด๋“œ๋กœ ์†ก๊ธˆ ์ „์†ก์นด๋“œ๋กœ ์†ก๊ธˆ ์ˆ˜์‹ ์นด๋“œ๋กœ ์†ก๊ธˆ ๊ฑฐ์ ˆ์นด๋“œ๋กœ ์†ก๊ธˆ ์ทจ์†ŒATM ์ถœ๊ธˆ์šฉ ์ผํšŒ์šฉ Token ๋ฐœ๊ธ‰ATM ์ถœ๊ธˆ ์˜ˆ์•ฝATM ์ถœ๊ธˆ ์˜ˆ์•ฝ ์ทจ์†ŒATM ์ถœ๊ธˆ ์ •๋ณด ์กฐํšŒ์„ ๋ถˆ์นด๋“œ ์„ ๋ฌผํ•˜๊ธฐ์„ ๋ถˆ์นด๋“œ ์„ ๋ฌผํ•˜๊ธฐ ์ทจ์†Œ์„ ๋ถˆ์นด๋“œ ์„ ๋ฌผํ•˜๊ธฐ ์œ ํšจ์„ฑ ๊ฒ€์ฆ์„ ๋ถˆ์นด๋“œ ์„ ๋ฌผํ•˜๊ธฐ ์ˆ˜๋ฝ์„ ๋ถˆ์นด๋“œ ์„ ๋ฌผํ•˜๊ธฐ ๊ฑฐ์ ˆ๋ฐ›์€ ์นด๋“œ/์ฟ ํฐ ์„ ๋ฌผ ๋ชฉ๋ก ์กฐํšŒ๋ณด๋‚ธ ์นด๋“œ/์ฟ ํฐ ์„ ๋ฌผ ๋ชฉ๋ก ์กฐํšŒ์นด๋“œ ์„ ๋ฌผ ์ˆ˜๋ฝ V2์นด๋“œ ์„ ๋ฌผํ•˜๊ธฐ V2์นด๋“œ ์ž”์•ก ์ด๊ด€์ž”์•ก ์ด๊ด€ ์นด๋“œ ์ •๋ณด ์กฐํšŒํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰ ์š”์ฒญํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰ ์ทจ์†Œํ˜„๊ธˆ์˜์ˆ˜์ฆ ๊ตญ์„ธ์ฒญ ์Šน์ธ์˜ค๋ฅ˜ ์š”์ฒญํ˜„๊ธˆ์˜์ˆ˜์ฆ ์‹๋ณ„ ์ •๋ณด ๋“ฑ๋กํ˜„๊ธˆ์˜์ˆ˜์ฆ ์‹๋ณ„ ์ •๋ณด ์กฐํšŒํ˜„๊ธˆ์˜์ˆ˜์ฆ ์‹๋ณ„ ์ •๋ณด ์‚ญ์ œํ˜„๊ธˆ์˜์ˆ˜์ฆ ๊ฐ€๋งน์  ๋“ฑ๋กํ˜„๊ธˆ์˜์ˆ˜์ฆ ๊ฐ€๋งน์  ์ˆ˜์ •๊ฐ€๋งน์  ๊ทธ๋ฃน ์ƒ์„ฑ๊ฐ€๋งน์  ๊ทธ๋ฃน ์ˆ˜์ •๊ฐ€๋งน์  ๊ทธ๋ฃน ์กฐํšŒ๊ฐ€๋งน์  ์ •๋ณด ์กฐํšŒ๊ฐ€๋งน์  ๊ทธ๋ฃน ๋‚ด ๊ฐ€๋งน์  ์ถ”๊ฐ€๊ฐ€๋งน์  ๊ทธ๋ฃน ๋‚ด ๊ฐ€๋งน์  ์‚ญ์ œ์‹ ์šฉ์นด๋“œ ์ž๋™์ถฉ์ „ ์„ค์ •(๊ธฐ์ค€ ํ•˜ํ•œ)์‹ ์šฉ์นด๋“œ ์ž๋™์ถฉ์ „ ์„ค์ •(์›”์ •์•ก)์‹ ์šฉ์นด๋“œ ์ž๋™์ถฉ์ „ ํ™œ์„ฑํ™”์‹ ์šฉ์นด๋“œ ์ž๋™์ถฉ์ „ ๋ชฉ๋ก ์กฐํšŒ์‹ ์šฉ์นด๋“œ ์ž๋™์ถฉ์ „ ์„ค์ • ํ•ด์ œ์‹ ์šฉ์นด๋“œ ์ž๋™ ์ถฉ์ „ ์„ค์ • ๋ณ€๊ฒฝ์นด๋“œ ์ƒํ’ˆ ์ „์ฒด ์กฐํšŒ (๊ด€๋ฆฌ์ž์šฉ)์นด๋“œ ์ƒํ’ˆ ์ƒ์„ธ ์กฐํšŒ (๊ด€๋ฆฌ์ž์šฉ)๋ฐœ๊ธ‰ ์นด๋“œ ๋ชฉ๋ก ์กฐํšŒ (๊ด€๋ฆฌ์ž์šฉ)์นด๋“œ ์ƒํ’ˆ ์ƒ์„ฑ API (๊ด€๋ฆฌ์ž์šฉ)์นด๋“œ ์„ ๋ฌผ ๋‚ด์—ญ ์กฐํšŒ (๊ด€๋ฆฌ์ž์šฉ)