HTTP Request 노드 문서

n8n에서 HTTP Request 노드를 사용해 REST API를 갖춘 모든 앱이나 서비스에 HTTP 요청을 보내는 방법을 설명합니다.

HTTP Request 노드는 n8n에서 가장 다재다능한 노드 중 하나입니다. REST API를 갖춘 모든 앱이나 서비스에 HTTP 요청을 보내 데이터를 조회할 수 있습니다. HTTP Request 노드는 일반 노드로 사용할 수도 있고, AI 에이전트 에 연결하여 도구 { data-preview }로 사용할 수도 있습니다. 이 노드를 사용할 때는 REST API 호출을 생성하는 것이므로, 기본적인 API 용어와 개념에 대한 이해가 어느 정도 필요합니다. HTTP 요청을 생성하는 방법에는 두 가지가 있습니다. 노드 파라미터 를 구성하거나 curl 명령을 가져오는 것입니다. Note 자격 증명 인증 설정에 대한 안내는 HTTP Request 자격 증명 을 참고하세요. 노드 파라미터 # 메서드 # 요청에 사용할 메서드를 선택합니다: 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 Paramete