HTTP Request 노드 문서

n8n의 HTTP Request 노드를 사용하여 REST API를 호출하고, 쿼리 파라미터·헤더·바디 설정, 페이지네이션, 응답 최적화 등 다양한 HTTP 요청 기능을 활용하는 방법을 설명합니다.

HTTP Request 노드는 n8n에서 가장 다재다능한 노드 중 하나입니다. REST API를 제공하는 모든 앱 또는 서비스에서 데이터를 쿼리하기 위한 HTTP 요청을 만들 수 있습니다. HTTP Request 노드를 일반 노드로 사용하거나 AI 에이전트 에 연결하여 툴 { data-preview }로 사용할 수도 있습니다. 이 노드를 사용하면 REST API 호출을 생성하게 됩니다. 기본적인 API 용어와 개념에 대한 이해가 필요합니다. HTTP 요청을 생성하는 방법은 두 가지입니다: 노드 파라미터 를 구성하거나 curl 명령어를 가져오기 합니다. 자격 증명 인증 설정에 대한 안내는 HTTP Request 자격 증명 을 참조하세요. 노드 파라미터 # Method # 요청에 사용할 메서드를 선택합니다: DELETE GET HEAD OPTIONS PATCH POST PUT URL # 사용할 엔드포인트를 입력합니다. Authentication # 사용 가능한 경우 Predefined Credential Type 옵션을 사용하는 것을 권장합니다. 일반 자격 증명 구성에 비해 자격 증명을 보다 쉽게 설정하고 관리할 수 있습니다. 사전 정의된 자격 증명 # n8n이 지원하는 연동에 대한 자격 증명으로, 내장 노드와 커뮤니티 노드 모두 포함됩니다. 추가 설정 없이 커스텀 작업에 Predefined Credential Type 을 사용하세요. 자세한 내용은 Custom API operations 를 참조하세요. 일반 자격 증명 # n8n이 지원하지 않는 연동에 대한 자격 증명입니다. 필요한 API 엔드포인트, 파라미터, 인증 방법 등 인증 프로세스를 수동으로 구성해야 합니다. 다음 방법 중 하나를 선택할 수 있습니다: Basic auth Custom auth Digest auth Header auth OAuth1 API OAuth2 API Query auth 각 자격 증명 유형 설정에 대한 자세한 내용은 HTTP request 자격 증명 을 참조하세요. Send Query Parameters # 쿼리 파라미터는 HTTP 요청의 필터 역할을 합니다. 상호작용하는 API가 이를 지원하고 요청에 필터가 필요한 경우 이 옵션을 켜세요. 다음 옵션 중 하나를 사용하여 쿼리 파라미터를 지정 합니다: Using Fields Below : Query Parameters 의 Name / Value 쌍을 입력합니다. 더 많은 쿼리 파라미터 이름/값 쌍을 추가하려면 Add Parameter 를 선택합니다. 이름은 필터링할 필드의 이름이고, 값은 필터 값입니다. Using JSON : JSON 을 입력하여 쿼리 파라미터를 정의합니다. 자세한 안내는 서비스의 API 문서를 참조하세요. Send Headers # 이 파라미터를 사용하여 요청과 함께 헤더를 전송합니다. 헤더에는 요청에 대한 메타데이터 또는 컨텍스트가 포함됩니다. 다음 옵션 중 하나를 사용하여 헤더를 지정 합니다: Using Fields Below : Header Parameters 의 Name / Value