D: 🚀 n8n의 HTTP Node는 외부 API와의 통신을 간편하게 만들어주는 강력한 도구입니다! 이 가이드에서는 HTTP Node의 모든 기능을 상세히 설명하고, 실제 업무에 바로 적용할 수 있는 10가지 실전 예제를 소개합니다.
🔍 HTTP Node란?
n8n에서 HTTP Node는 REST API 엔드포인트와 상호작용할 수 있게 해주는 표준 노드입니다.
✔️ GET/POST/PUT/DELETE 등 모든 HTTP 메서드 지원
✔️ 헤더, 쿼리 파라미터, 본문(body) 데이터 설정 가능
✔️ 인증(Authentication) 다양한 방식 지원 (Basic, Bearer, OAuth 등)
// 기본 구성 예시
{
"method": "GET",
"url": "https://api.example.com/data",
"headers": {
"Content-Type": "application/json"
}
}
⚙️ HTTP Node 설정 상세 설명
-
URL 입력 필드
- 기본 엔드포인트 주소 입력 (예:
https://api.weather.com/v1/forecast
) - 동적 값은
{{ }}
로 감싸 표현식 사용 가능 (예:{{$node["Webhook"].json["city"]}}
)
- 기본 엔드포인트 주소 입력 (예:
-
메서드 선택
- GET: 데이터 조회 (예: 날씨 정보 가져오기)
- POST: 데이터 생성 (예: 새 주문 등록)
- PUT/PATCH: 데이터 수정
- DELETE: 데이터 삭제
-
인증 설정
// Bearer Token 예시 { "authentication": "bearerToken", "bearerToken": "your_api_key_here" }
-
헤더 & 파라미터
- 커스텀 헤더 추가 가능 (예:
X-API-Version: 2.0
) - URL 쿼리 파라미터 자동 생성 (예:
?limit=10&offset=0
)
- 커스텀 헤더 추가 가능 (예:
🔥 실전 예제 10가지
1️⃣ 날씨 API 연동 (OpenWeatherMap)
{
"method": "GET",
"url": "https://api.openweathermap.org/data/2.5/weather",
"qs": {
"q": "{{$node["Trigger"].json["location"]}}",
"appid": "your_api_key"
}
}
> 용도: 특정 도시의 현재 날씨 데이터 가져오기 🌤️
2️⃣ Slack 메시지 전송
{
"method": "POST",
"url": "https://slack.com/api/chat.postMessage",
"headers": {
"Authorization": "Bearer xoxb-your-token"
},
"body": {
"channel": "#general",
"text": "🚨 긴급: 서버 다운 발생!"
}
}
3️⃣ Google Sheets 데이터 추가 (via API)
// POST 요청 본문 예시
{
"values": [
["2023-11-20", "n8n 구매", "299.00"]
]
}
4️⃣ CRM 연동 (HubSpot)
{
"method": "POST",
"url": "https://api.hubapi.com/crm/v3/objects/contacts",
"headers": {
"Authorization": "Bearer YOUR_HUBSPOT_KEY"
},
"body": {
"properties": {
"email": "{{$node["Form"].json["email"]}}",
"firstname": "{{$node["Form"].json["first_name"]}}"
}
}
}
5️⃣ 이미지 다운로드 & Cloud Storage 업로드
- 첫 번째 HTTP Node: 이미지 URL에서 바이너리 데이터 GET
- 두 번째 HTTP Node: AWS S3/GCP Storage에 PUT 요청으로 업로드
🛠️ 문제 해결 팁
- 429 Too Many Requests 오류:
Rate Limit
노드 추가하여 요청 간 지연 설정 - SSL 인증서 문제: 설정에서 “Ignore SSL Issues” 활성화 (개발 환경에서만 사용)
- 응답 파싱: JSONPath 사용법 익히기 (예:
{{$json["data"]["items"][0]["id"]}}
)
📊 고급 활용법
- 페이징 처리:
Link
헤더나 응답의next_page
필드를 활용해 자동 페이지네이션 구현 - 오토메이션 체인: HTTP 요청 결과를 다른 노드(IF, Function)와 연결해 조건부 처리
- 에러 핸들링: “Continue on Fail” 옵션으로 부분 실패 허용
💡 마무리: HTTP Node는 n8n 워크플로우의 핵심 연결고리입니다! 이 가이드의 예제들을 참고해 다양한 서비스와의 연동을 시도해보세요. 추가 궁금한 점은 댓글로 문의주세요! 👇
> ✨ Bonus: n8n 공식 문서에서 최신 API 연동 사례 확인하기 → n8n Docs 링크