HTTP ์ปค๋„ฅํ„ฐ ์˜ค๋ฅ˜ ์žก๊ธฐ

Prev Next

HTTP API ์ปค๋„ฅํ„ฐ ์˜ค๋ฅ˜๋ฅผ ํฌ์ฐฉํ•˜๋Š” ์‚ฌ์šฉ ์‚ฌ๋ก€์™€ ์˜ค๋ฅ˜๋ฅผ ๊ธฐ๋กํ•˜๊ณ  ์ปค๋„ฅํ„ฐ ๊ธฐ๋Šฅ์„ ๋‹ค์‹œ ์‹œ๋„ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์ดํ•ดํ•ฉ๋‹ˆ๋‹ค.

HTTP ์ปค๋„ฅํ„ฐ ์˜ค๋ฅ˜์˜ ์œ ํ˜•

HTTP ํ”„๋กœํ† ์ฝœ ํ‘œ์ค€์—๋Š” HTTP ์‘๋‹ต ์ฝ”๋“œ์™€ HTTP ์‘๋‹ต ๋ฉ”์‹œ์ง€๋กœ ์•Œ๋ ค์ง„ ์„œ๋ฒ„ ์‘๋‹ต ์ฝ”๋“œ ๋ฐ ๋ฉ”์‹œ์ง€์— ๋Œ€ํ•œ ์š”๊ตฌ ์‚ฌํ•ญ์ด ํฌํ•จ๋˜์–ด ์žˆ์œผ๋ฉฐ, ์ด๋ฅผ ํ†ตํ•ด ์ตœ์ข… ์‚ฌ์šฉ์ž๊ฐ€ ๋ฐœ์ƒํ•œ ์˜ค๋ฅ˜ ์œ ํ˜•์„ ์ง๊ด€์ ์œผ๋กœ ํŒŒ์•…ํ•  ์ˆ˜ ์žˆ๋„๋ก ํ‘œ์ค€ HTTP ์‘๋‹ต ์ฝ”๋“œ ํด๋ž˜์Šค ๋˜๋Š” ์นดํ…Œ๊ณ ๋ฆฌ๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค.์ด๋Ÿฌํ•œ ์ฝ”๋“œ ํด๋ž˜์Šค๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.* 1XX - ์ •๋ณด ์‘๋‹ต์š”์ฒญ์ด์ˆ˜์‹ ๋˜์–ด ํ”„๋กœ์„ธ์Šค๊ฐ€ ๊ณ„์† ์ง„ํ–‰ ์ค‘* 2XX - ์„ฑ๊ณต์š”์ฒญ์ด์„ฑ๊ณต์ ์œผ๋กœ ์ˆ˜์‹ , ์ดํ•ด ๋ฐ ์ˆ˜๋ฝ๋จ* 3XX - ๋ฆฌ๋””๋ ‰์…˜์š”์ฒญ์„์™„๋ฃŒํ•˜๋ ค๋ฉด ์ถ”๊ฐ€์กฐ์น˜๋ฅผ ์ทจํ•ด์•ผ ํ•จ* 4XX - ํด๋ผ์ด์–ธํŠธ ์˜ค๋ฅ˜์š”์ฒญ์ด์ž˜๋ชป๋œ ๊ตฌ๋ฌธ์„ ํฌํ•จํ•˜๊ฑฐ๋‚˜ ์ดํ–‰ํ•  ์ˆ˜ ์—†์Œ* 5XX - ์„œ๋ฒ„ ์˜ค๋ฅ˜์™ธํ˜•์ƒ์œ ํšจํ•œ ์š”์ฒญ์„ ์„œ๋ฒ„๊ฐ€ ์ดํ–‰ํ•˜์ง€ ๋ชปํ–ˆ์Šต๋‹ˆ๋‹ค.

๊ฐ€์žฅ ์ผ๋ฐ˜์ ์ธ ์˜ค๋ฅ˜ ์ฝ”๋“œ๋Š” 404 - ์ฐพ์„ ์ˆ˜ ์—†์Œ ๋˜๋Š” 500 - ๋‚ด๋ถ€ ์„œ๋ฒ„ ์˜ค๋ฅ˜์ž…๋‹ˆ๋‹ค. ์ด๋Ÿฌํ•œ ์˜ค๋ฅ˜ ์ฝ”๋“œ๋Š” ์™ธ๋ถ€ ์‹œ์Šคํ…œ ์„œ๋ฒ„๊ฐ€ ๋‹ค์šด๋˜์—ˆ๊ฑฐ๋‚˜, ์œ ์ง€ ๊ด€๋ฆฌ๊ฐ€ ์ง„ํ–‰ ์ค‘์ด๊ฑฐ๋‚˜, ์„œ๋น„์Šค์— ๋ฌธ์ œ๊ฐ€ ์žˆ๊ฑฐ๋‚˜, ๋„คํŠธ์›Œํฌ์— ๋ฌธ์ œ๊ฐ€ ์žˆ์Œ์„ ๋‚˜ํƒ€๋‚ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์˜ˆ์‹œ: ์•ฑ์—์„œ HTTP ์˜ค๋ฅ˜ ํฌ์ฐฉํ•˜๊ธฐ

๋‹ค์Œ ์˜ˆ์ œ์—์„œ๋Š” HTTP ์ปค๋„ฅํ„ฐ ๊ธฐ๋Šฅ ์˜ค๋ฅ˜๋ฅผ ํ‘œ์‹œํ•˜๋„๋ก ์•ฑ์„ ๊ตฌ์„ฑํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์ž์„ธํžˆ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.

์ปค๋„ฅํ„ฐ ํ•จ์ˆ˜ ๋นŒ๋“œํ•˜๊ธฐ

์ปค๋„ฅํ„ฐ ํ•จ์ˆ˜ ๋นŒ๋”์—์„œ ์ปค๋„ฅํ„ฐ Output ๊ตฌ์„ฑ์— HTTP ์˜ค๋ฅ˜ ์ฝ”๋“œ ๋ฐ ์˜ค๋ฅ˜ ๋ฉ”์‹œ์ง€๋ฅผ ๋งคํ•‘ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ๋‚˜์ค‘์— Tulip ์•ฑ์—์„œ ์‚ฌ์šฉํ•  ์ปค๋„ฅํ„ฐ ํ•จ์ˆ˜ ์ถœ๋ ฅ์œผ๋กœ HTTP ์˜ค๋ฅ˜ ์ฝ”๋“œ์™€ ์˜ค๋ฅ˜ ๋ฉ”์‹œ์ง€๊ฐ€ ์ „๋‹ฌ๋ฉ๋‹ˆ๋‹ค.

  1. HTTP ์ƒํƒœ ํ•„๋“œ๋ฅผ ์ถœ๋ ฅ์— ๋งคํ•‘ํ•ฉ๋‹ˆ๋‹ค.Connector Output Mapping 1.png
  2. ์ถœ๋ ฅ์— ๋ช…ํ™•ํ•˜๊ณ  ๊ณ ์œ ํ•œ ์ด๋ฆ„์„ ์ง€์ •ํ•˜๊ณ  ์ปค๋„ฅํ„ฐ ํ•จ์ˆ˜๋ฅผ ๋‹ค์‹œ ์‹คํ–‰ํ•˜์—ฌ ์ถœ๋ ฅ์ด ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ํ‘œ์‹œ๋˜๋Š”์ง€ ํ…Œ์ŠคํŠธํ•ฉ๋‹ˆ๋‹ค.Connector Output Mapping 2.png

Catch Connector Errors Overview.gif{height="" width=""} ์˜ˆ์ œ์ฒ˜๋Ÿผ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

์ปค๋„ฅํ„ฐ ์˜ค๋ฅ˜๋ฅผ ์ฒ˜๋ฆฌํ•˜๋Š” ์•ฑ ๋นŒ๋“œํ•˜๊ธฐ

์•ฑ์—์„œ ์ปค๋„ฅํ„ฐ์˜ ์ถœ๋ ฅ ์ •๋ณด๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ปค๋„ฅํ„ฐ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ๋ฅผ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

์•ฑ ํŠธ๋ฆฌ๊ฑฐ์—์„œ ์ปค๋„ฅํ„ฐ ์‹คํ–‰

์ปค๋„ฅํ„ฐ ํ•จ์ˆ˜ ์‹คํ–‰์œผ๋กœ ํŠธ๋ฆฌ๊ฑฐ ์•ก์…˜์„ ๋นŒ๋“œํ•˜์„ธ์š”. ๋ฐฉ๊ธˆ ๋นŒ๋“œํ•œ ์ปค๋„ฅํ„ฐ์™€ ํ•จ์ˆ˜๋ฅผ ์„ ํƒํ•œ ๋‹ค์Œ ๊ฒฐ๊ณผ๋ฅผ ๋ณ€์ˆ˜๋กœ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค.Run Connector Trigger - Error Catching.png

์ด์ œ HTTP ์‘๋‹ต ์ฝ”๋“œ์™€ ๋ฉ”์‹œ์ง€๋ฅผ ์ƒˆ ์•ฑ ๋ณ€์ˆ˜์—์„œ ์ฐธ์กฐ๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.HTTP Response Code as Variable.png

์•ฑ์—์„œ ์ปค๋„ฅํ„ฐ ์‘๋‹ต ์‹œ๊ฐํ™”ํ•˜๊ธฐ

์ „์ฒด ์ปค๋„ฅํ„ฐ ์‘๋‹ต ๋ณ€์ˆ˜๋ฅผ ํ‘œ์‹œํ•˜๋Š” ๋ณ€์ˆ˜ ์œ„์ ฏ์„ ์•ฑ ๋‹จ๊ณ„์— ๋ฐฐ์น˜ํ•˜์„ธ์š”.Visualize connector response with variable widget.gif

์ปค๋„ฅํ„ฐ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ ํŠธ๋ฆฌ๊ฑฐ ๋นŒ๋“œ

๋‹ค์Œ์œผ๋กœ HTTP ์‘๋‹ต ์ฝ”๋“œ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ํ›„์† ํŠธ๋ฆฌ๊ฑฐ ์กฐ๊ฑด์— ๋Œ€ํ•ด ์•ฑ ์ˆ˜์ค€์˜ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ๋ฅผ ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  1. ์ปค๋„ฅํ„ฐ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ๋ฅผ ์ˆ˜ํ–‰ํ•  ์ƒˆ ํŠธ๋ฆฌ๊ฑฐ๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค.Connector Error Handling Trigger.png
  2. ์ž˜๋ชป๋œ HTTP ์‘๋‹ต ์ฝ”๋“œ๋ฅผ ์ฐพ๋Š” ์กฐ๊ฑด์„ ๋งŒ๋“ญ๋‹ˆ๋‹ค. ์ด ์˜ˆ์ œ์—์„œ๋Š” 200.:: : (Info) (Note)
    Many systems use a 200 response code as a good response, but it is best to check with the API endpoint provider or IT if all good responses will only be of code 200
    :::
  3. ์กฐ๊ฑด์ด ์ถฉ์กฑ๋  ๋•Œ, HTTP ์‘๋‹ต ์ฝ”๋“œ๊ฐ€ ์ž˜๋ชป๋œ ๊ฒฝ์šฐ ํŠธ๋ฆฌ๊ฑฐ ์•ก์…˜์ด ๋ฐœ์ƒํ•  ํŠธ๋ฆฌ๊ฑฐ๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค.Bad Response Code Trigger.png

์•ฑ์—์„œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค:HTTP Error Response Overview.gif

์ถ”๊ฐ€ ์ž๋ฃŒ