Mindlogic Logo
Docs
/
์‚ฌ์šฉ์ž๊ด€๋ฆฌ์ž
API Gateway
ํŒฉํŠธ์ฑ—/๊ณ„์ •ยท์„ค์ •/๊ฐœ์ธํ™”

๊ฐœ์ธํ™” (Personalize)

๊ฐœ์ธํ™” ํŽ˜์ด์ง€๋Š” ํŒฉํŠธ์ฑ—๊ฐ€ ๋‚˜์— ๋Œ€ํ•ด ๋ฌด์—‡์„ ๊ธฐ์–ตํ•˜๊ณ , ์–ด๋–ค ์™ธ๋ถ€ ๋ฐ์ดํ„ฐ์— ์—ฐ๊ฒฐ๋˜์–ด ์žˆ๋Š”์ง€๋ฅผ ํ•œ ๊ณณ์—์„œ ํ™•์ธยท๊ด€๋ฆฌํ•˜๋Š” ํŽ˜์ด์ง€์ž…๋‹ˆ๋‹ค. ๋Œ€ํ™”๋ฅผ ๋ฐ˜๋ณตํ• ์ˆ˜๋ก AI๊ฐ€ ๋‚˜์— ๋Œ€ํ•ด ํ•™์Šตํ•˜๊ณ , ์—ฐ๊ฒฐ๋œ ํŒŒ์ผ๊ณผ ๋„๊ตฌ๋ฅผ ๋‹ต๋ณ€์— ํ™œ์šฉํ•ฉ๋‹ˆ๋‹ค.

๊ฐœ์š”

ํ•ญ๋ชฉ๋™์ž‘
์ง„์ž… ์œ„์น˜์‚ฌ์ด๋“œ๋ฐ” โ†’ Personalize
ํƒญ ๊ตฌ์„ฑ๊ฐœ์š” ยท ๋ฉ”๋ชจ๋ฆฌ ยท ๋ฐ์ดํ„ฐ ์—ฐ๋™ (๋ฐ์ดํ„ฐ ์—ฐ๋™ ํƒญ์€ ์กฐ์ง์ด ํ—ˆ์šฉํ•œ ๊ฒฝ์šฐ์—๋งŒ ํ‘œ์‹œ)
์ƒํƒœ ํ‘œ์‹œ์ƒ๋‹จ ํžˆ์–ด๋กœ์— ์ง€๊ธˆ๊นŒ์ง€ ๋‚˜๋ˆˆ ๋Œ€ํ™” ์ˆ˜, ๊ธฐ์–ตํ•œ ํ•ญ๋ชฉ ์ˆ˜, ์—ฐ๊ฒฐ๋œ ๋ฐ์ดํ„ฐ ์†Œ์Šค ์ˆ˜๊ฐ€ ํ•จ๊ป˜ ๋‚˜์˜ด
์š”๊ธˆ์ œยทํฌ๋ ˆ๋”งยทํ™˜๊ฒฝ์„ค์ • ๋“ฑ ๊ณ„์ • ์ „๋ฐ˜ ์„ค์ •์€ ๋งˆ์ดํŽ˜์ด์ง€์—์„œ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

๊ฐœ์š” ํƒญ

์ง€๊ธˆ๊นŒ์ง€ ์Œ“์ธ ๊ฐœ์ธํ™” ์ƒํƒœ๋ฅผ ํ•œ๋ˆˆ์— ๋ณด์—ฌ์ฃผ๋Š” ๋Œ€์‹œ๋ณด๋“œ์ž…๋‹ˆ๋‹ค.
์นด๋“œ์„ค๋ช…
ํžˆ์–ด๋กœ"์ง€๊ธˆ๊นŒ์ง€ N๋ฒˆ์˜ ๋Œ€ํ™”์—์„œ M๊ฐ€์ง€๋ฅผ ๊ธฐ์–ตํ–ˆ์Šต๋‹ˆ๋‹ค" ํ˜•ํƒœ๋กœ ํ•™์Šต ์ง„ํ–‰ ์ƒํ™ฉ์„ ์š”์•ฝ
๋ฉ”๋ชจ๋ฆฌ ์š”์•ฝ๋Œ€ํ™”์—์„œ ๋ฐฐ์šด ๋‚ด์šฉ์„ ์งง๊ฒŒ ์ •๋ฆฌํ•ด์„œ ํ‘œ์‹œ
์—ฐ๊ฒฐ๋œ ๋ฐ์ดํ„ฐ ์š”์•ฝ์—ฐ๊ฒฐ๋œ ์†Œ์Šค ๊ฐœ์ˆ˜์™€ ์ตœ๊ทผ ์ถ”๊ฐ€๋œ ํ•ญ๋ชฉ
์ตœ๊ทผ ์ถ”๊ฐ€๋จ์ƒˆ๋กœ ๊ธฐ์–ต๋œ ์ˆœ์„œ๋Œ€๋กœ ์ •๋ ฌ๋œ ์ตœ๊ทผ ํ•ญ๋ชฉ
๋ฉ”๋ชจ๋ฆฌ๊ฐ€ ๊บผ์ ธ ์žˆ๊ฑฐ๋‚˜ ์•„์ง ์•„๋ฌด๊ฒƒ๋„ ๊ธฐ์–ตํ•œ ๊ฒŒ ์—†์œผ๋ฉด, ๋Œ€ํ™” ์‹œ์ž‘ํ•˜๊ธฐ ยท ๊ธฐ์–ตํ•  ๋‚ด์šฉ ์•Œ๋ ค์ฃผ๊ธฐ ยท ๋ฐ์ดํ„ฐ ์—ฐ๊ฒฐํ•˜๊ธฐ 3๋‹จ๊ณ„ ์˜จ๋ณด๋”ฉ์ด ๋‚˜ํƒ€๋‚ฉ๋‹ˆ๋‹ค.

๋ฉ”๋ชจ๋ฆฌ ํƒญ

AI๊ฐ€ ๋‚˜์— ๋Œ€ํ•ด ๊ธฐ์–ตํ•œ ์ •๋ณด๋ฅผ ํ™•์ธํ•˜๊ณ , ๊ฐœ๋ณ„๋กœ ์ง€์šฐ๊ฑฐ๋‚˜ ์ „์ฒด๋ฅผ ์ดˆ๊ธฐํ™”ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ฉ”๋ชจ๋ฆฌ๋Š” ๋‘ ์ข…๋ฅ˜๋กœ ๋‚˜๋‰ฉ๋‹ˆ๋‹ค.
์ข…๋ฅ˜์ฑ„์›Œ์ง€๋Š” ๋ฐฉ์‹
์ €์žฅ๋œ ์ •๋ณด์ฑ„ํŒ…์—์„œ "์ด๊ฑด ๊ธฐ์–ตํ•ด์ค˜"์ฒ˜๋Ÿผ ๋ช…์‹œ์ ์œผ๋กœ ์•Œ๋ ค์ฃผ๋ฉด ์ €์žฅ๋จ. ์‚ญ์ œยท์ˆ˜์ • ๊ฐ€๋Šฅ
ํ•™์Šตํ•œ ๋‚ด์šฉ์—ฌ๋Ÿฌ ๋Œ€ํ™”๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ AI๊ฐ€ ์ž๋™์œผ๋กœ ์š”์•ฝํ•œ ๋‚˜์— ๋Œ€ํ•œ ์ง€์‹. ์ง์ ‘ ํŽธ์ง‘ ๋ถˆ๊ฐ€, ์ „์ฒด ์‚ญ์ œ๋งŒ ๊ฐ€๋Šฅ

์ผœ๊ณ  ๋„๊ธฐ

์ƒ๋‹จ์˜ ๋ฉ”๋ชจ๋ฆฌ ํ™œ์„ฑํ™” ํ† ๊ธ€๋กœ ๋ฉ”๋ชจ๋ฆฌ ๊ธฐ๋Šฅ์„ ์ผœ๊ฑฐ๋‚˜ ๋Œ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ๋„๋ฉด ์ƒˆ๋กœ์šด ์ •๋ณด๊ฐ€ ๋” ์ด์ƒ ์ €์žฅ๋˜์ง€ ์•Š์ง€๋งŒ, ์ด์ „์— ์ €์žฅ๋œ ํ•ญ๋ชฉ์€ ๋‚จ์•„ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์™„์ „ํžˆ ์ดˆ๊ธฐํ™”ํ•˜๋ ค๋ฉด ์ €์žฅ๋œ ์ •๋ณด์™€ ํ•™์Šตํ•œ ๋‚ด์šฉ ์˜์—ญ์—์„œ ๊ฐ๊ฐ ์‚ญ์ œํ•˜์„ธ์š”.
๋Œ€ํ™” ์ค‘ "์ด๊ฑด ๊ธฐ์–ตํ•ด์ค˜"๋ผ๊ณ  ๋งํ•˜๋ฉด ์ƒˆ๋กœ์šด ํ•ญ๋ชฉ์ด ์ €์žฅ๋œ ์ •๋ณด์— ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค. ์ด ๋ถ€๋ถ„์€ ์–ธ์ œ๋“  ๋ชฉ๋ก์—์„œ ์ˆ˜์ •ยท์‚ญ์ œํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋ฐ์ดํ„ฐ ์—ฐ๋™ ํƒญ

ํŒŒ์ผยท๋ฌธ์„œยท์™ธ๋ถ€ ์‹œ์Šคํ…œ์„ ์—ฐ๊ฒฐํ•ด ๋‹ต๋ณ€์— ํ™œ์šฉํ•ฉ๋‹ˆ๋‹ค. ์กฐ์ง์ด ํ—ˆ์šฉํ•œ ๊ฒฝ์šฐ์—๋งŒ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.
์—ฐ๊ฒฐ๋œ ๋ฐ์ดํ„ฐ ์„น์…˜์—๋Š” ์ด๋ฏธ ์—ฐ๊ฒฐ๋œ ์†Œ์Šค๊ฐ€ ์นด๋“œ๋กœ ๋‚˜์—ด๋˜๊ณ , ๊ทธ ์•„๋ž˜ ์นดํƒˆ๋กœ๊ทธ์—์„œ ์ƒˆ ์†Œ์Šค๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Google Drive

Google Drive๋ฅผ ์—ฐ๊ฒฐํ•˜๋ฉด ๋‹ค์Œ ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:
  • Drive์— ์ €์žฅ๋œ ๋ฌธ์„œ๋ฅผ ๊ฒ€์ƒ‰ํ•˜๊ณ  ํŒŒ์ผ ๋‚ด์šฉ์„ ์ฝ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ฑ„ํŒ…์—์„œ ํŒŒ์ผ์„ ์ง์ ‘ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ํŒŒ์ผ ์ด๋ฆ„์ด ์ •ํ™•ํžˆ ๊ธฐ์–ต๋‚˜์ง€ ์•Š์•„๋„ ๋ฌธ์„œ๋ฅผ ์ฐพ๊ณ , ๋‚ด์šฉ์„ ๋ถ„์„ํ•˜๊ฑฐ๋‚˜ ๋‹ค๋ฅธ ํ˜•์‹์œผ๋กœ ๋ณ€ํ™˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์—ฐ๊ฒฐ ๋ฐฉ๋ฒ•
  1. ๋ฐ์ดํ„ฐ ์—ฐ๋™ ํƒญ์—์„œ Google Drive์˜ ์—ฐ๊ฒฐ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  2. Google ๊ณ„์ •์œผ๋กœ ๋กœ๊ทธ์ธํ•˜๊ณ  ๊ถŒํ•œ์„ ์Šน์ธํ•ฉ๋‹ˆ๋‹ค.
  3. ์—ฐ๊ฒฐ์ด ์™„๋ฃŒ๋˜๋ฉด ์—ฐ๊ฒฐ๋œ ๊ณ„์ • ์ •๋ณด๊ฐ€ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.
์—ฐ๊ฒฐ์„ ํ•ด์ œํ•˜๋ ค๋ฉด ์—ฐ๊ฒฐ ํ•ด์ œ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

์™ธ๋ถ€ API

์›ํ•˜๋Š” REST API๋ฅผ ์ง์ ‘ ๋“ฑ๋กํ•˜๋ฉด AI๊ฐ€ ๋Œ€ํ™” ์ค‘ ํ•„์š”ํ•œ ์‹œ์ ์— ํ•ด๋‹น API๋ฅผ ํ˜ธ์ถœํ•˜์—ฌ ์‘๋‹ต์— ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์‚ฌ๋‚ด ์‹œ์Šคํ…œ, ๊ณต๊ณต ๋ฐ์ดํ„ฐ API ๋“ฑ ์™ธ๋ถ€ ์„œ๋น„์Šค์˜ ๋ฐ์ดํ„ฐ๋ฅผ ์ฑ—๋ด‡์—์„œ ๊ณง๋ฐ”๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
API ์ถ”๊ฐ€ํ•˜๊ธฐ
  1. ๋ฐ์ดํ„ฐ ์—ฐ๋™ ํƒญ์˜ ์™ธ๋ถ€ API ์„น์…˜์—์„œ ์ถ”๊ฐ€ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  2. ์•„๋ž˜ ์ •๋ณด๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.
ํ•ญ๋ชฉ์„ค๋ช…
์ด๋ฆ„API์˜ ํ‘œ์‹œ ์ด๋ฆ„ (์˜ˆ: Weather API)
๋ฒ ์ด์Šค URLAPI์˜ ๊ธฐ๋ณธ ์ฃผ์†Œ (์˜ˆ: https://api.example.com)
์„ค๋ช…API์˜ ์šฉ๋„์™€ ํŠน์ง• (์„ ํƒ)
  1. ์ถ”๊ฐ€ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•˜๋ฉด ์™ธ๋ถ€ API ๋ชฉ๋ก์— ์ƒˆ ์นด๋“œ๊ฐ€ ๋“ฑ๋ก๋ฉ๋‹ˆ๋‹ค.
์‚ฌ์šฉ์ž๋‹น ์™ธ๋ถ€ API์™€ ๋‹ค๋ฅธ ๋ฐ์ดํ„ฐ ์—ฐ๋™์„ ํ•ฉ์ณ ์ตœ๋Œ€ 50๊ฐœ๊นŒ์ง€ ๋“ฑ๋กํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ๊ฐ API๋‹น ์ตœ๋Œ€ 20๊ฐœ์˜ ์—”๋“œํฌ์ธํŠธ๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์ธ์ฆ ์ •๋ณด ์„ค์ •
API ํ˜ธ์ถœ์— ์ธ์ฆ์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ, ๋“ฑ๋ก๋œ ์นด๋“œ๋ฅผ ํด๋ฆญํ•˜์—ฌ ํŽธ์ง‘ ํŒจ๋„์„ ์—ด๊ณ  ์ธ์ฆ ์„น์…˜์—์„œ ๋‹ค์Œ์„ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.
ํ•ญ๋ชฉ์„ค๋ช…
๊ธฐ๋ณธ ํ—ค๋”๋ชจ๋“  ์š”์ฒญ์— ์ž๋™์œผ๋กœ ํฌํ•จ๋  HTTP ํ—ค๋” (์˜ˆ: Authorization: Bearer <token>)
๊ธฐ๋ณธ ํŒŒ๋ผ๋ฏธํ„ฐ๋ชจ๋“  ์š”์ฒญ์— ์ž๋™์œผ๋กœ ํฌํ•จ๋  ์ฟผ๋ฆฌ ํŒŒ๋ผ๋ฏธํ„ฐ (์˜ˆ: api_key=...)
์ธ์ฆ ๊ฐ’์€ ์ €์žฅ ์‹œ ๋งˆ์Šคํ‚น ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค. ๋ณ€๊ฒฝ ์‹œ ์ƒˆ๋กœ์šด ๊ฐ’์œผ๋กœ ๊ต์ฒด๋ฉ๋‹ˆ๋‹ค.
์—”๋“œํฌ์ธํŠธ ์ถ”๊ฐ€
๊ฐ API์—๋Š” ํ˜ธ์ถœ ๊ฐ€๋Šฅํ•œ ์—”๋“œํฌ์ธํŠธ(๊ฒฝ๋กœ)๋ฅผ ๋“ฑ๋กํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ํŽธ์ง‘ ํŒจ๋„์˜ ์—”๋“œํฌ์ธํŠธ ์„น์…˜์—์„œ ์—”๋“œํฌ์ธํŠธ ์ถ”๊ฐ€ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
ํ•ญ๋ชฉ์„ค๋ช…
HTTP ๋ฉ”์„œ๋“œGET, POST, PUT, PATCH, DELETE, HEAD ์ค‘ ์„ ํƒ
๊ฒฝ๋กœ๋ฒ ์ด์Šค URL ๋’ค์— ๋ถ™์„ ๊ฒฝ๋กœ (์˜ˆ: /users/{id})
์„ค๋ช…์—”๋“œํฌ์ธํŠธ์˜ ์šฉ๋„, ํŒŒ๋ผ๋ฏธํ„ฐ, ์‘๋‹ต ํ˜•์‹ ์„ค๋ช… (AI๊ฐ€ ํ˜ธ์ถœ ์‹œ์ ยท๋ฐฉ๋ฒ• ๊ฒฐ์ • ์‹œ ํ™œ์šฉ)
์„ค๋ช… ์ž‘์„ฑ ํŒ: ํŒŒ๋ผ๋ฏธํ„ฐ์˜ ํƒ€์ž…ยทํ•„์ˆ˜ ์—ฌ๋ถ€, ์‘๋‹ต ๊ตฌ์กฐ๋ฅผ ์ž์„ธํžˆ ์ ์„์ˆ˜๋ก AI๊ฐ€ ๋” ์ •ํ™•ํ•˜๊ฒŒ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.
์„ค๋ช… ์˜ˆ์‹œ:
์‚ฌ์šฉ์ž ID๋กœ ํ”„๋กœํ•„์„ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค. ํŒŒ๋ผ๋ฏธํ„ฐ: - id (์ •์ˆ˜, ํ•„์ˆ˜): ์‚ฌ์šฉ์ž ๊ณ ์œ  ID - include_avatar (๋ถˆ๋ฆฌ์–ธ, ์„ ํƒ): ์•„๋ฐ”ํƒ€ URL ํฌํ•จ ์—ฌ๋ถ€ ์‘๋‹ต: { name, email, role, avatar_url }
์—”๋“œํฌ์ธํŠธ๋ณ„๋กœ ํ™œ์„ฑ/๋น„ํ™œ์„ฑ ํ† ๊ธ€์ด ์ œ๊ณต๋˜๋ฉฐ, ๋น„ํ™œ์„ฑ ์—”๋“œํฌ์ธํŠธ๋Š” AI๊ฐ€ ํ˜ธ์ถœํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ฑ—๋ด‡ยท์ฑ„ํŒ…์—์„œ ์‚ฌ์šฉ

  • ๊ฐœ์ธ ์ฑ„ํŒ…: ๋ฉ”์‹œ์ง€ ์ž…๋ ฅ์ฐฝ์˜ ์ฒจ๋ถ€ ๋ฉ”๋‰ด(+ ๋ฒ„ํŠผ)์—์„œ ์‚ฌ์šฉํ•  ์†Œ์Šค๋ฅผ ํ† ๊ธ€๋กœ ํ™œ์„ฑํ™”ํ•˜๋ฉด, ํ•ด๋‹น ๋Œ€ํ™”์—์„œ AI๊ฐ€ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.
  • Studio ์ฑ—๋ด‡: ์ฑ—๋ด‡ ํŽธ์ง‘ ํŽ˜์ด์ง€์˜ ์™ธ๋ถ€ API ํ•ญ๋ชฉ์—์„œ ์ถ”๊ฐ€ ๋ฒ„ํŠผ์„ ๋ˆŒ๋Ÿฌ ๋“ฑ๋ก๋œ API๋ฅผ ์ฑ—๋ด‡์— ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค.
  • ์ฐธ์กฐ ์ด๋ฏธ์ง€: Google Drive์— ์ €์žฅ๋œ ์ด๋ฏธ์ง€๋ฅผ ์ด๋ฏธ์ง€ ์ƒ์„ฑ ์ฐธ์กฐ ์ด๋ฏธ์ง€๋กœ ๋ฐ”๋กœ ๋ถˆ๋Ÿฌ์˜ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์—ฐ๊ฒฐ๋œ API์˜ ์šฐ์ธก ์ƒ๋‹จ์—๋Š” ํ—ฌ์Šค ์ฒดํฌ ๊ฒฐ๊ณผ(์—ฐ๊ฒฐ๋จ / ์˜คํ”„๋ผ์ธ / ์‹œ๊ฐ„ ์ดˆ๊ณผ)๊ฐ€ ํ‘œ์‹œ๋˜์–ด ์ •์ƒ ๋™์ž‘ ์—ฌ๋ถ€๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋งˆ์ง€๋ง‰ ์ˆ˜์ • ๋‚ ์งœ: Jul 22, 2026

์ด์ „

ํ”„๋กœํ•„

๋‹ค์Œ

๋งˆ์ดํŽ˜์ด์ง€

๋ชฉ์ฐจ