HTTP Request 노드는 n8n에서 가장 다재다능한 노드 중 하나입니다. REST API를 갖춘 모든 앱이나 서비스에 HTTP 요청을 보내 데이터를 조회할 수 있습니다. HTTP Request 노드는 일반 노드로 사용할 수도 있고, AI 에이전트에 연결하여 도구{ data-preview }로 사용할 수도 있습니다.

이 노드를 사용할 때는 REST API 호출을 생성하는 것이므로, 기본적인 API 용어와 개념에 대한 이해가 어느 정도 필요합니다.

HTTP 요청을 생성하는 방법에는 두 가지가 있습니다. 노드 파라미터를 구성하거나 curl 명령을 가져오는 것입니다.

노드 파라미터#

메서드#

요청에 사용할 메서드를 선택합니다:

• DELETE
• GET
• HEAD
• OPTIONS
• PATCH
• POST
• PUT

URL#

사용하려는 엔드포인트를 입력합니다.

인증#

n8n은 가능한 경우 Predefined Credential Type 옵션 사용을 권장합니다. 일반(generic) 자격 증명을 구성하는 것보다 자격 증명을 더 쉽게 설정하고 관리할 수 있습니다.

사전 정의된 자격 증명#

내장 노드와 커뮤니티 노드를 포함하여 n8n이 지원하는 통합의 자격 증명입니다. 추가 설정 없이 커스텀 작업을 수행하려면 Predefined Credential Type을 사용하세요. 자세한 내용은 기존 노드에 대한 커스텀 API 작업을 참고하세요.

일반 자격 증명#

n8n이 지원하지 않는 통합의 자격 증명입니다. 필요한 API 엔드포인트, 필수 파라미터, 인증 방식 지정 등 인증 과정을 직접 구성해야 합니다.

다음 방식 중 하나를 선택할 수 있습니다:

• Basic auth
• Custom auth
• Digest auth
• Header auth
• OAuth1 API
• OAuth2 API
• Query auth

각 자격 증명 유형을 설정하는 방법에 대한 자세한 내용은 HTTP Request 자격 증명을 참고하세요.

쿼리 매개변수 전송#

쿼리 파라미터는 HTTP 요청에서 필터 역할을 합니다. 상호작용하는 API가 쿼리 파라미터를 지원하고 보내려는 요청에 필터가 필요하다면, 이 옵션을 켜세요.

사용 가능한 옵션 중 하나를 사용하여 쿼리 파라미터를 지정합니다:

• Using Fields Below: Query Parameters의 Name/Value 쌍을 입력합니다. 쿼리 파라미터 이름/값 쌍을 더 추가하려면 Add Parameter를 선택합니다. 이름은 필터링할 필드의 이름이고, 값은 필터 값입니다.
• Using JSON: JSON을 입력하여 쿼리 파라미터를 정의합니다.

자세한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

헤더 전송#

이 파라미터를 사용하여 요청과 함께 헤더를 보냅니다. 헤더에는 요청에 대한 메타데이터나 컨텍스트가 포함됩니다.

사용 가능한 옵션 중 하나를 사용하여 헤더를 지정합니다:

• Using Fields Below: Header Parameters의 Name/Value 쌍을 입력합니다. 헤더 파라미터 이름/값 쌍을 더 추가하려면 Add Parameter를 선택합니다. 이름은 설정하려는 헤더이고, 값은 해당 헤더에 전달하려는 값입니다.
• Using JSON: JSON을 입력하여 헤더 파라미터를 정의합니다.

자세한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

본문 전송#

API 요청과 함께 본문(body)을 보내야 한다면, 이 옵션을 켜세요.

그런 다음 보내려는 본문 콘텐츠의 형식에 가장 잘 맞는 Body Content Type을 선택합니다.

Form URLencoded#

이 옵션을 사용하면 본문을 application/x-www-form-urlencoded로 보냅니다.

사용 가능한 옵션 중 하나를 사용하여 본문을 지정합니다:

• Using Fields Below: Body Parameters의 Name/Value 쌍을 입력합니다. 본문 파라미터 이름/값 쌍을 더 추가하려면 Add Parameter를 선택합니다. 이름은 폼 필드 이름이어야 하고, 값은 해당 필드에 설정하려는 값입니다.
• Using Single Field: 이름/값 쌍을 fieldname1=value1&fieldname2=value2 형식으로 단일 Body 파라미터에 입력합니다.

자세한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

Form-Data#

이 옵션을 사용하면 본문을 multipart/form-data로 보냅니다.

Parameter Type을 선택하여 Body Parameters를 구성합니다:

• Form Data를 선택하면 Name/Value 쌍을 입력합니다.
• n8n Binary File을 선택하면 노드가 접근할 수 있는 파일에서 본문을 가져옵니다.
  • Name: 설정할 필드의 ID를 입력합니다.
  • Input Data Field Name: 처리하려는 바이너리 파일 데이터가 담긴 수신 필드의 이름을 입력합니다.

파라미터를 더 입력하려면 Add Parameter를 선택합니다.

자세한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

JSON#

이 옵션을 사용하면 본문을 JSON으로 보냅니다.

사용 가능한 옵션 중 하나를 사용하여 본문을 지정합니다:

• Using Fields Below: Body Parameters의 Name/Value 쌍을 입력합니다. 본문 파라미터 이름/값 쌍을 더 추가하려면 Add Parameter를 선택합니다.
• Using JSON: JSON을 입력하여 본문을 정의합니다.

자세한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

n8n 바이너리 파일#

이 옵션을 사용하면 n8n에 저장된 파일의 내용을 본문으로 보냅니다.

파일이 담긴 수신 필드의 이름을 Input Data Field Name에 입력합니다.

파일 형식을 지정하는 방법에 대한 자세한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

Raw#

이 옵션을 사용하면 본문에 원시(raw) 데이터를 보냅니다.

• Content Type: 원시 본문 콘텐츠에 사용할 Content-Type 헤더를 입력합니다. MIME 콘텐츠 유형의 전체 목록은 IANA Media types 문서를 참고하세요.
• Body: 보낼 원시 본문 콘텐츠를 입력합니다.

자세한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

노드 옵션#

Add Option을 선택하면 다음 옵션을 확인하고 선택할 수 있습니다. 별도로 명시하지 않는 한 옵션은 모든 파라미터에서 사용할 수 있습니다.

쿼리 매개변수의 배열 형식#

이 옵션을 사용하여 쿼리 파라미터에 포함된 배열의 형식을 제어합니다. 다음 옵션 중에서 선택하세요:

• No Brackets: 배열의 각 항목이 name=value 형식으로 지정됩니다. 예: foo=bar&foo=qux.
• Brackets Only: 노드가 각 배열 이름 뒤에 대괄호를 추가합니다. 예: foo[]=bar&foo[]=qux.
• Brackets with Indices: 노드가 각 배열 이름 뒤에 인덱스 값이 포함된 대괄호를 추가합니다. 예: foo[0]=bar&foo[1]=qux.

어떤 옵션을 사용해야 하는지에 대한 안내는 사용 중인 서비스의 API 문서를 참고하세요.

배칭#

많은 수의 입력 항목을 배치 처리하는 방식을 제어합니다:

• Items per Batch: 각 배치에 포함할 입력 항목의 수를 입력합니다.
• Batch Interval: 각 요청 배치 사이에 대기할 시간을 밀리초 단위로 입력합니다. 배치 간격을 두지 않으려면 0을 입력합니다.

SSL 문제 무시#

기본적으로 n8n은 SSL 인증서 검증에 성공한 경우에만 응답을 다운로드합니다. SSL 인증서 검증에 실패하더라도 응답을 다운로드하려면 이 옵션을 켜세요.

헤더 소문자화#

헤더 이름을 소문자로 변환할지(켜짐, 기본값) 여부(꺼짐)를 선택합니다.

리디렉션#

리디렉션을 따를지(기본적으로 켜짐) 여부(꺼짐)를 선택합니다. 켜면 요청이 따라야 하는 최대 리디렉션 수를 Max Redirects에 입력합니다.

응답#

이 옵션을 사용하여 예상되는 API 응답에 대한 세부 사항을 설정합니다:

• Include Response Headers and Status: 기본적으로 노드는 본문만 반환합니다. 이 옵션을 켜면 본문과 함께 전체 응답(헤더 및 응답 상태 코드)도 반환합니다.
• Never Error: 기본적으로 노드는 응답이 2xx 코드로 반환될 때만 성공을 반환합니다. 이 옵션을 켜면 반환되는 코드와 관계없이 성공을 반환합니다.
• Response Format: 데이터가 반환되는 형식을 선택합니다. 다음 중에서 선택하세요:
  • Autodetect(기본값): 노드가 반환된 데이터를 기반으로 응답을 감지하고 형식을 지정합니다.
  • File: 이 옵션을 선택하면 응답을 파일에 넣습니다. 파일을 반환할 필드 이름을 Put Output in Field에 입력합니다.
  • JSON: 이 옵션을 선택하면 응답을 JSON 형식으로 지정합니다.
  • Text: 이 옵션을 선택하면 응답을 일반 텍스트 형식으로 지정합니다. 파일을 반환할 필드 이름을 Put Output in Field에 입력합니다.

페이지네이션#

이 옵션을 사용하여 결과를 페이지네이션합니다. API가 단일 호출로 반환하기에 너무 큰 쿼리 결과를 처리할 때 유용합니다.

페이지네이션 이해하기

페이지네이션은 큰 데이터 집합을 여러 페이지로 분할하는 것을 의미합니다. 각 페이지의 데이터 양은 설정한 한도(limit)에 따라 달라집니다.

예를 들어 /users라는 엔드포인트에 API 호출을 한다고 가정합니다. API는 사용자 300명에 대한 정보를 반환하려 하지만, 이는 API가 한 번의 응답으로 보내기에는 너무 많은 데이터입니다.

API가 페이지네이션을 지원하면 데이터를 점진적으로 가져올 수 있습니다. 이를 위해 페이지네이션 한도와 함께 API가 어느 페이지를 보낼지 알려주는 페이지 번호 또는 URL을 지정하여 /users를 호출합니다. 이 예에서는 한도를 10으로 사용하고 0페이지부터 시작한다고 가정합니다. API는 응답으로 처음 10명의 사용자를 보냅니다. 그런 다음 페이지 번호를 1 증가시켜 API를 다시 호출하면 다음 10개의 결과를 얻습니다.

페이지네이션 설정을 구성합니다:

• Pagination Mode:
  • Off: 페이지네이션을 끕니다.
  • Update a Parameter in Each Request: 각 요청에 대해 파라미터를 동적으로 설정해야 할 때 사용합니다.
  • Response Contains Next URL: API 응답에 다음 페이지의 URL이 포함되어 있을 때 사용합니다. 표현식(expression)을 사용하여 Next URL을 설정합니다.

설정 예시는 HTTP Request 노드 쿡북 | Pagination을 참고하세요.

n8n은 페이지네이션을 사용할 때 HTTP 노드 요청 및 응답을 다룰 수 있는 내장 변수를 제공합니다:

프록시#

HTTP 프록시를 지정해야 할 때 이 옵션을 사용합니다.

요청이 사용할 Proxy를 입력합니다. 이는 HTTP_PROXY, HTTPS_PROXY 또는 ALL_PROXY 환경 변수로 정의된 전역 설정보다 우선합니다.

Timeout#

이 옵션을 사용하여 노드가 서버로부터 응답 헤더(및 응답 본문 시작)를 받을 때까지 대기할 시간을 설정합니다. 노드는 초기 응답에 대해 이 값을 초과하는 요청을 중단합니다.

대기할 Timeout 시간을 밀리초 단위로 입력합니다.

도구 전용 옵션#

다음 옵션은 AI 에이전트에 도구{ data-preview }로 연결된 경우에만 사용할 수 있습니다.

응답 최적화#

LLM에 전달되는 데이터 양을 줄이기 위해 도구 응답을 최적화할지 여부입니다. 응답을 최적화하면 비용을 절감할 수 있고 LLM이 중요하지 않은 세부 사항을 무시하도록 도와, 대체로 더 나은 결과로 이어집니다.

응답을 최적화할 때는 예상 응답 유형을 선택하며, 이에 따라 구성할 수 있는 다른 옵션이 결정됩니다. 지원되는 응답 유형은 다음과 같습니다:

JSON#

JSON 응답이 예상되는 경우, 다음 선택지를 사용하여 JSON 데이터의 어느 부분을 응답으로 사용할지 구성할 수 있습니다:

• Field Containing Data: 이 필드는 관련 데이터가 담긴 JSON 객체의 특정 부분을 식별합니다. 전체 응답을 사용하려면 비워 둘 수 있습니다.
• Include Fields: 응답 객체에 원하는 필드를 선택하는 방법입니다. 세 가지 선택지가 있습니다:
  • All: 응답 객체의 모든 필드를 포함합니다.
  • Selected: 아래에 지정한 필드만 포함합니다.
    • Fields: 응답에 포함할 필드의 쉼표로 구분된 목록입니다. 점 표기법(dot notation)을 사용하여 중첩된 필드를 지정할 수 있습니다. Input 패널에서 필드를 드래그하여 필드 목록에 추가할 수 있습니다.
  • Exclude: 아래에 지정한 필드를 제외한 모든 필드를 포함합니다.
    • Fields: 응답에서 제외할 필드의 쉼표로 구분된 목록입니다. 점 표기법을 사용하여 중첩된 필드를 지정할 수 있습니다. Input 패널에서 필드를 드래그하여 필드 목록에 추가할 수 있습니다.

HTML#

HTML이 예상되는 경우, 다음 옵션을 사용하여 LLM과 관련된 HTML 문서 부분을 식별하고 응답을 최적화할 수 있습니다:

• Selector (CSS): 응답 HTML에 포함할 특정 요소 또는 요소 유형입니다. 기본적으로 body 요소를 사용합니다.
• Return Only Content: 응답에서 HTML 태그와 속성을 제거하여 실제 콘텐츠만 남길지 여부입니다. 이렇게 하면 토큰을 더 적게 사용하며 모델이 이해하기 더 쉬울 수 있습니다.
  • Elements To Omit: 콘텐츠를 추출할 때 제외할 CSS 선택자의 쉼표로 구분된 목록입니다.
• Truncate Response: 토큰을 절약하기 위해 응답 크기를 제한할지 여부입니다.
  • Max Response Characters: HTML 응답에 포함할 최대 문자 수입니다. 기본값은 1000입니다.

텍스트#

일반 Text 응답이 예상되는 경우, 다음 옵션을 사용하여 결과를 최적화할 수 있습니다:

• Truncate Response: 토큰을 절약하기 위해 응답 크기를 제한할지 여부입니다.
  • Max Response Characters: HTML 응답에 포함할 최대 문자 수입니다. 기본값은 1000입니다.

curl 명령 가져오기#

curl은 URL로 데이터를 전송하는 명령줄 도구이자 라이브러리입니다.

curl을 사용하여 REST API를 호출할 수 있습니다. 사용하려는 서비스의 API 문서에 curl 예제가 제공되는 경우, 문서에서 복사하여 n8n에 붙여넣어 HTTP Request 노드를 구성할 수 있습니다.

curl 명령 가져오기:

1. HTTP Request 노드의 Parameters 탭에서 Import cURL을 선택합니다. Import cURL command 모달이 열립니다.
2. curl 명령을 텍스트 상자에 붙여넣습니다.
3. Import을 선택합니다. n8n이 요청 구성을 노드 필드에 로드합니다. 이는 기존 구성을 덮어씁니다.

템플릿 및 예제#

n8n-nodes-base.httprequest 통합 템플릿 둘러보기 또는 모든 템플릿 검색

일반적인 문제#

일반적인 질문이나 문제 및 제안된 해결책은 일반적인 문제를 참고하세요.