HTTP 요청

개요

항목	내용
카테고리	연동
대상	외부 REST API
출력	API 응답

설정 옵션

옵션	설명	필수
URL	요청 URL	✅
메서드	GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS	✅
헤더	Authorization, Content-Type 등
바디	요청 본문 (JSON)
인증	없음, Basic Auth, Bearer Token, API Key, OAuth2
응답 형식	JSON, Text, Binary, 자동 감지
타임아웃	요청 제한 시간 (기본 30초, 최대 5분)
에러 무시	HTTP 에러 응답(4xx, 5xx)을 에러로 처리하지 않음
리다이렉트 따라가기	리다이렉트 자동 처리 (기본 활성)

메서드

메서드	용도
GET	데이터 조회
POST	데이터 생성
PUT	데이터 전체 수정
PATCH	데이터 부분 수정
DELETE	데이터 삭제
HEAD	헤더만 조회
OPTIONS	지원 메서드 확인

헤더 설정

Content-Type

Content-Type: application/json

인증

Authorization: Bearer {{credentials.apiKey}}
Authorization: Basic {{base64(username:password)}}

커스텀 헤더

X-Custom-Header: {{trigger.row.customValue}}

바디 (요청 본문)

JSON

{
  "customer": "{{trigger.row.고객명}}",
  "amount": {{trigger.row.금액}},
  "items": {{trigger.row.상품목록}}
}

Form Data

name={{trigger.row.이름}}&email={{trigger.row.이메일}}

인증 방식

Bearer Token

Authorization: Bearer {{credentials.apiKey}}

Basic Auth

Authorization: Basic {{base64("username:password")}}

OAuth 2.0

Credentials에 등록된 OAuth 연결을 사용합니다.

출력 데이터

{{actions.http.status}}           // HTTP 상태 코드
{{actions.http.response}}         // 응답 본문 (JSON)
{{actions.http.response.id}}      // 응답의 특정 필드
{{actions.http.headers}}          // 응답 헤더

활용 예시

외부 시스템에 데이터 전송

POST https://api.external.com/orders
Headers:
  Authorization: Bearer {{credentials.apiKey}}
  Content-Type: application/json
Body:
{
  "customer": "{{trigger.row.고객명}}",
  "amount": {{trigger.row.금액}},
  "items": {{trigger.row.상품목록}}
}

외부 데이터 조회

GET https://api.external.com/products/{{trigger.row.productId}}
Headers:
  Authorization: Bearer {{credentials.apiKey}}

슬랙 웹훅

POST https://hooks.slack.com/services/xxx/yyy/zzz
Headers:
  Content-Type: application/json
Body:
{
  "text": "새 주문: {{trigger.row.주문번호}}"
}

에러 처리

API 호출이 실패할 수 있습니다. 에러 처리를 고려하세요.

상태 코드 확인

// 조건 분기에서
{{actions.http.status}} = 200  // 성공
{{actions.http.status}} >= 400 // 에러

재시도

HTTP 요청은 실패 시 자동으로 재시도합니다 (기본 3회).

모범 사례

민감 정보 보호

API 키는 Credentials에 저장하고 변수로 참조하세요.

❌ Authorization: Bearer sk-1234567890
✅ Authorization: Bearer {{credentials.openaiKey}}

타임아웃 설정

외부 API 응답이 느릴 수 있으므로 적절한 타임아웃을 설정하세요.

응답 검증

응답 형식이 예상과 다를 수 있으므로 검증 후 사용하세요.

On this page