n8n의 HTTP 노드는 워크플로우 내에서 외부 서버에 HTTP 요청을 보내고 응답을 처리하는 핵심 노드입니다. 🌐 마치 워크플로우가 웹상의 다른 서비스들과 대화할 수 있는 '전화기' 역할을 한다고 생각할 수 있습니다. 웹훅 노드가 외부의 요청을 받는 '수신기'라면, HTTP 노드는 외부로 요청을 보내는 '송신기'입니다.
주요 기능 및 설정
Method (메서드)
HTTP 요청의 종류를 선택합니다. GET, POST, PUT, DELETE, PATCH 등 다양한 메서드가 있습니다.
역할: API가 수행할 작업을 결정합니다. 예를 들어, GET은 데이터 조회, POST는 데이터 생성/전송에 사용됩니다.
GET: 데이터를 조회할 때 사용합니다. (예: 특정 사용자의 프로필 정보 가져오기)
POST: 새로운 데이터를 생성하거나 전송할 때 사용합니다. (예: 새로운 게시물 작성)
PUT: 기존 데이터를 업데이트하거나 교체할 때 사용합니다.
DELETE: 데이터를 삭제할 때 사용합니다.
URL (URL)
HTTP 요청을 보낼 웹 주소(URL)를 입력하는 칸입니다.
역할: API 엔드포인트의 위치를 지정하여 n8n이 어디로 요청을 보낼지 알려줍니다.
Authentication (인증)
API에 접근하기 위한 인증 방식을 설정합니다.
None (없음)
HTTP 요청에 별도의 인증 정보가 필요 없을 때 선택합니다.
사용 사례: 공개된 API 엔드포인트에 데이터를 요청할 때 사용합니다. 예를 들어, 날씨 정보나 공개된 데이터베이스를 조회할 때 이 옵션을 사용할 수 있습니다.
Predefined Credential Type (미리 정의된 자격 증명 유형)
n8n이 이미 통합되어 있는 다양한 서비스(예: Google Sheets, Slack, Trello 등)에 대한 인증 방식을 제공합니다. 사용자가 일일이 인증 정보를 수동으로 설정할 필요 없이, 해당 서비스의 계정을 n8n에 연결하기만 하면 됩니다.
사용 사례: n8n의 통합 서비스 목록에 있는 API를 호출할 때 사용합니다. 설정 과정이 간편하고 안전합니다.
Generic Credential Type (일반 자격 증명 유형)
미리 정의된 서비스가 아닌, 임의의 API에 대해 사용자 정의 인증 방식을 설정할 수 있습니다. 이 옵션을 선택하면 Basic Auth, OAuth2, API Key 등 다양한 인증 방식을 직접 구성할 수 있습니다.
사용 사례: n8n에 통합되지 않은 사내 API나, 커스텀 인증 방식을 사용하는 API를 호출할 때 사용합니다.
Send Query Parameters (쿼리 파라미터 보내기)
이 토글을 활성화하면 URL에 추가적인 데이터를 쿼리 파라미터 형식(?key=value)으로 포함시킬 수 있습니다.
역할: 데이터를 URL에 추가하여 GET 요청 시 필터링이나 정렬 등을 할 때 사용됩니다.
n8n의 HTTP Request 노드에서 **쿼리 파라미터(Query Parameters)**를 설정하는 화면입니다. 쿼리 파라미터는 HTTP 요청 URL 뒤에 ? 문자로 시작하여 추가 데이터를 전달하는 데 사용됩니다. 📝
Send Query Parameters (쿼리 파라미터 보내기)
설명: 이 토글 스위치를 켜면 쿼리 파라미터를 활성화하고, 끌 경우 비활성화합니다.
역할: 이 스위치를 켜야만 아래의 쿼리 파라미터 설정 항목이 활성화됩니다.
Specify Query Parameters (쿼리 파라미터 지정 방식)
설명: 쿼리 파라미터를 어떻게 입력할지 선택하는 드롭다운 메뉴입니다.
Using Fields Below (아래 필드 사용): 이 옵션을 선택하면 Name과 Value 필드에 직접 쿼리 파라미터의 이름과 값을 입력하여 설정할 수 있습니다. 가장 일반적인 방식입니다.
Using JSON (JSON 사용): JSON 형식으로 여러 쿼리 파라미터를 한 번에 입력할 수 있습니다. 복잡한 파라미터 목록을 다룰 때 유용합니다.
Query Parameters (쿼리 파라미터)
설명: Name과 Value 필드를 통해 실제 쿼리 파라미터의 이름과 값을 입력하는 부분입니다.
Name (이름): 쿼리 파라미터의 키(key)에 해당합니다. (예: q, limit, page)
Value (값): 쿼리 파라미터의 값(value)에 해당합니다. (예: n8n, 10, 1)
예시:
만약 Name에 search를, Value에 n8n을 입력하고 GET 요청을 보낸다면, 최종 URL은 http://example.com/api?search=n8n과 같이 구성됩니다. 여러 개의 파라미터를 추가하려면 Add Query Parameter 버튼을 눌러서 계속 추가할 수 있습니다.
쿼리 파라미터는 주로 데이터를 검색하거나, 필터링하거나, 페이지네이션 정보를 전달하는 등 서버에 추가적인 정보를 제공할 때 사용됩니다. 🔍
n8n의 HTTP Request 노드에서 **쿼리 파라미터(Query Parameters)**를 JSON 형식으로 설정하는 화면입니다. 📝
Specify Query Parameters (쿼리 파라미터 지정 방식)
설명: 쿼리 파라미터를 입력하는 방식을 선택하는 드롭다운 메뉴입니다. 여기서는 **'Using JSON'**이 선택되어 있어, 쿼리 파라미터를 JSON 객체 형태로 입력하게 됩니다.
JSON
설명: 이 텍스트 필드에 직접 JSON 형식의 데이터를 입력합니다. JSON 객체의 키(key)가 쿼리 파라미터의 이름이 되고, 값이 쿼리 파라미터의 값이 됩니다.
예시: 다음과 같이 입력하면 ?user=john&role=admin과 같은 쿼리 스트링이 생성됩니다.
JSON
{
"user": "john",
"role": "admin"
}
장점: 여러 개의 쿼리 파라미터를 한눈에 구조적으로 입력하고 관리할 수 있어 편리합니다. 특히 복잡하거나 많은 수의 파라미터를 다룰 때 유용합니다.
Using JSON 방식은 Using Fields Below 방식과 기능적으로 동일하지만, 입력 방식에서 차이가 있습니다. JSON 형식을 사용하면 더 많은 파라미터를 효율적으로 입력하고, 이전 노드의 데이터를 JSON 형태로 쉽게 연결(expression)하여 사용할 수 있다는 장점이 있습니다. ✅
Send Headers (헤더 보내기)
이 토글을 활성화하면 요청에 추가적인 HTTP 헤더를 포함시킬 수 있습니다.
역할: Content-Type과 같은 요청의 형식 정보나, API Key 인증 토큰 등 중요한 정보를 담는 데 사용됩니다.
이 이미지는 n8n의 HTTP Request 노드에서 **헤더(Headers)**를 설정하는 화면입니다. HTTP 헤더는 요청이나 응답에 대한 추가적인 정보를 담는 데 사용됩니다. 📝
Send Headers (헤더 보내기)
설명: 이 토글 스위치를 켜면 HTTP 요청에 헤더를 포함시킬 수 있습니다.
역할: 이 스위치가 켜져야만 아래의 헤더 설정 항목이 활성화됩니다.
Specify Headers (헤더 지정 방식)
설명: 헤더를 입력하는 방식을 선택하는 드롭다운 메뉴입니다.
Using Fields Below (아래 필드 사용): 이 옵션을 선택하면 Name과 Value 필드에 직접 헤더의 이름과 값을 입력하여 설정합니다. 가장 일반적이고 직관적인 방식입니다.
Using JSON (JSON 사용): JSON 형식으로 여러 헤더를 한 번에 입력할 수 있습니다.
Header Parameters (헤더 파라미터)
설명: Name과 Value 필드를 통해 실제 헤더의 이름과 값을 입력하는 부분입니다.
Name (이름): 헤더의 키(key)에 해당합니다. (예: Content-Type, Authorization)
Value (값): 헤더의 값(value)에 해당합니다. (예: application/json, Bearer abcde12345)
예시:
만약 Name에 Content-Type을, Value에 application/json을 입력하면, HTTP 요청에 Content-Type: application/json이라는 헤더가 추가됩니다. 이는 서버에 요청 본문이 JSON 형식임을 알려주는 역할을 합니다.
헤더는 주로 인증 토큰(Authorization), 데이터 형식(Content-Type), 요청을 보낸 곳(Origin) 등 API 호출에 필수적이거나 중요한 정보를 전달하는 데 사용됩니다. 🔑
Send Body (본문 보내기)
이 토글을 활성화하면 요청의 본문(Body)에 데이터를 포함시킬 수 있습니다.
역할: POST, PUT 요청처럼 서버에 새로운 데이터를 보내야 할 때 사용합니다. JSON, 폼 데이터, 바이너리 파일 등 다양한 형식으로 데이터를 전송할 수 있습니다.
이 이미지는 n8n의 HTTP Request 노드에서 **본문(Body)**을 설정하는 화면입니다. 본문은 POST, PUT, PATCH 요청을 통해 서버로 데이터를 보낼 때 사용됩니다. 📤
Send Body (본문 보내기)
설명: 이 토글 스위치를 켜면 요청에 본문을 포함시킬 수 있습니다.
Body Content Type (본문 콘텐츠 유형)
설명: 보낼 데이터의 형식을 선택하는 드롭다운 메뉴입니다. API가 요구하는 형식에 맞게 선택해야 합니다.
Form Urlencoded (폼 URL 인코딩)
설명: HTML 폼(form)의 데이터를 전송할 때 사용하는 형식입니다. 키-값(key-value) 쌍을 URL 인코딩하여 보냅니다.
사용 사례: 전통적인 웹 폼 데이터를 전송할 때 사용됩니다.
Form-Data (폼 데이터)
설명: 여러 종류의 데이터를 한 번에 보낼 수 있는 형식입니다. 텍스트 필드와 파일 데이터를 함께 보낼 때 주로 사용됩니다.
사용 사례: 파일을 업로드하거나, 폼 데이터와 파일을 혼합해서 보낼 때 사용됩니다.
JSON
설명: 가장 널리 사용되는 데이터 형식입니다. 키-값 쌍으로 이루어진 객체나 배열 형태로 데이터를 전송합니다.
사용 사례: 대부분의 최신 REST API들이 JSON 형식을 요구하므로, API 연동 시 가장 많이 사용됩니다.
n8n Binary File (n8n 바이너리 파일)
설명: n8n 워크플로우에서 생성되거나 다운로드된 바이너리 파일(예: 이미지, PDF)을 전송할 때 사용합니다.
사용 사례: 이전 노드에서 다운로드한 파일을 HTTP 요청을 통해 다른 서비스로 업로드해야 할 때 유용합니다.
Raw (원시)
설명: 데이터를 파싱하지 않고, 원시(raw) 텍스트 그대로 전송합니다.
사용 사례: JSON, XML, HTML, 일반 텍스트 등 특별한 포맷 없이 그대로 보내야 할 때 사용됩니다. 예를 들어, 웹페이지의 HTML 소스를 그대로 서버로 보낼 때 이 옵션을 선택할 수 있습니다.
이러한 옵션들을 통해 HTTP 요청에 포함될 데이터의 형식을 정확하게 지정할 수 있습니다. 💡
Options (옵션)
HTTP 노드의 동작을 세밀하게 제어하는 추가 설정 항목들입니다.
Batching (배칭)
한 번의 HTTP 요청에 여러 항목을 묶어서 보낼 수 있게 해줍니다.
사용 사례: 여러 개의 데이터를 생성하거나 업데이트할 때, 항목 하나당 한 번씩 요청을 보내는 대신 여러 항목을 한 번에 보내 API 호출 횟수를 줄일 수 있습니다.
Ignore SSL Issues (Insecure) (SSL 문제 무시)
HTTPS 요청을 보낼 때 SSL 인증서의 유효성을 검사하지 않도록 합니다. 보안상 매우 위험하므로 신뢰할 수 없는 환경에서는 사용하지 않는 것이 좋습니다.
사용 사례: 자체 서명(self-signed) SSL 인증서를 사용하거나, 개발/테스트 환경에서 임시로 API를 호출해야 할 때 사용합니다.
Lowercase Headers (헤더 소문자화)
응답 헤더의 이름을 모두 소문자로 변환합니다.
사용 사례: 일부 API가 헤더 이름을 대소문자 구분 없이 처리하지만, 그렇지 않은 경우도 있어 일관성을 유지하기 위해 사용합니다.
Redirects (리다이렉트)
요청이 리다이렉트(재경로)될 때 어떻게 처리할지 설정합니다.
사용 사례: HTTP 요청이 다른 URL로 리다이렉트될 경우 자동으로 따라갈지, 아니면 원래 URL에서 중단할지 지정할 수 있습니다.
Response (응답)
API 응답을 어떻게 처리할지 설정합니다. 예를 들어, 응답 데이터를 JSON으로 파싱할지, 아니면 바이너리 파일로 처리할지 등을 지정합니다.
사용 사례: API가 JSON이 아닌 HTML, XML, 바이너리 파일 등을 반환할 때 이 옵션을 사용합니다.
Pagination (페이지네이션)
API 응답이 여러 페이지로 나뉘어 있을 때, 모든 페이지의 데이터를 자동으로 가져오도록 설정합니다.
사용 사례: 대량의 데이터를 여러 페이지에 걸쳐 제공하는 API(예: 수백 개의 사용자 목록)에서 모든 데이터를 한 번에 가져와야 할 때 매우 유용합니다.
Proxy (프록시)
HTTP 요청을 특정 프록시 서버를 통해 보내도록 설정합니다.
사용 사례: 특정 IP 주소에서만 접근 가능한 API를 호출하거나, 익명성을 유지해야 할 때 사용합니다.
Timeout (타임아웃)
HTTP 요청이 완료될 때까지 기다릴 최대 시간을 밀리초(ms) 단위로 설정합니다.
사용 사례: API 응답이 너무 늦거나 응답하지 않을 경우 무한정 기다리지 않고 정해진 시간 후에 요청을 중단하고 실패 처리를 하도록 설정할 수 있습니다.
HTTP 노드 활용 사례
HTTP 노드는 n8n 워크플로우에서 가장 자주 사용되는 노드 중 하나입니다. 다양한 방식으로 활용할 수 있습니다.
API 연동: 외부 서비스의 API를 호출하여 데이터를 가져오거나 전송합니다. 예를 들어, 구글 캘린더에 새 이벤트를 추가하거나, 슬랙(Slack)으로 메시지를 보내는 등의 작업을 할 수 있습니다. 🤖
파일 다운로드: 웹에서 이미지를 다운로드하거나, CSV 파일을 가져와서 워크플로우에서 처리할 수 있습니다.
데이터 스크래핑: 웹페이지의 HTML 데이터를 가져와서 특정 정보를 추출할 수 있습니다.
자동화된 알림: 특정 이벤트 발생 시, HTTP 노드를 이용해 외부 메시징 서비스로 알림을 보낼 수 있습니다.