<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="definition">정의</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>HTTP 프로토콜을 통해 서버 요청을 전송할 수 있으며, 외부 데이터 검색, 웹훅, 이미지 생성, 파일 다운로드 등의 시나리오에 적합합니다. 지정된 웹 주소로 맞춤형 HTTP 요청을 전송하여 다양한 외부 서비스와의 상호 연결을 구축할 수 있습니다.이 노드는 일반적인 HTTP 요청 방법을 지원합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li><strong>GET</strong>&nbsp;: 서버에 특정 리소스를 보내달라고 요청하는 데 사용됩니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>POST</strong>&nbsp;: 일반적으로 양식을 제출하거나 파일을 업로드하여 서버에 데이터를 제출하는 데 사용됩니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>HEAD</strong>&nbsp;: GET 요청과 비슷하지만, 서버는 리소스 본문 없이 응답 헤더만 반환합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>PATCH</strong>&nbsp;: 리소스에 부분적인 수정 사항을 적용하는 데 사용됩니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>PUT</strong>&nbsp;: 서버에 리소스를 업로드하는 데 사용되며, 일반적으로 기존 리소스를 업데이트하거나 새 리소스를 만드는 데 사용됩니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>DELETE</strong>&nbsp;: 서버에 지정된 리소스를 삭제하도록 요청하는 데 사용됩니다.</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p>URL, 요청 헤더, 쿼리 매개변수, 요청 본문 내용, 인증 정보를 포함하여 HTTP 요청의 다양한 측면을 구성할 수 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":743,"width":"837px","height":"auto","sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large is-resized"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-53-469x1024.png" alt="" class="wp-image-743" style="width:837px;height:auto"/></figure>
<!-- /wp:image -->

<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="scenarios"><a href="https://docs.dify.ai/en/guides/workflow/node/http-request#scenarios">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/http-request#scenarios"></a>시나리오</h3>
<!-- /wp:heading -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li><strong>특정 서버로 애플리케이션 상호 작용 콘텐츠 보내기</strong></li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p>이 노드의 실용적인 기능 중 하나는 시나리오에 따라 요청의 여러 부분에 변수를 동적으로 삽입할 수 있다는 것입니다. 예를 들어, 고객 피드백 요청을 처리할 때 사용자 이름이나 고객 ID, 피드백 내용 등의 변수를 요청에 임베드하여 자동 응답 메시지를 맞춤 설정하거나 특정 고객 정보를 가져와 관련 리소스를 지정된 서버로 전송할 수 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":744,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-54-1024x330.png" alt="" class="wp-image-744"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p>HTTP 요청의 반환 값에는 응답 본문, 상태 코드, 응답 헤더, 파일이 포함됩니다. 특히, 응답에 파일이 포함된 경우, 이 노드는 워크플로의 후속 단계에서 사용할 수 있도록 해당 파일을 자동으로 저장할 수 있습니다. 이러한 설계는 처리 효율성을 향상시킬 뿐만 아니라, 파일이 포함된 응답을 간단하고 직접적으로 처리할 수 있도록 합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li><strong>파일 보내기</strong></li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p>HTTP PUT 요청을 사용하여 애플리케이션에서 다른 API 서비스로 파일을 전송할 수 있습니다. 요청 본문에서 <code>binary</code> 내의 파일 변수를 선택할 수 있습니다. 이 방법은 파일 전송, 문서 저장 또는 미디어 처리와 같은 시나리오에서 일반적으로 사용됩니다.예: 문서 관리 애플리케이션을 개발 중이고 사용자가 업로드한 PDF 파일을 타사 서비스로 전송해야 한다고 가정해 보겠습니다. HTTP 요청 노드를 사용하여 파일 변수를 전달할 수 있습니다.구성 예는 다음과 같습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":748,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-56-1024x848.png" alt="" class="wp-image-748"/></figure>
<!-- /wp:image -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="advanced-features"><a href="https://docs.dify.ai/en/guides/workflow/node/http-request#advanced-features">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/http-request#advanced-features"></a>고급 기능</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p><strong>실패 시 재시도</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>노드에서 발생하는 일부 예외의 경우, 일반적으로 노드를 다시 시도하는 것으로 충분합니다. 오류 재시도 기능이 활성화되어 있으면 오류 발생 시 노드는 미리 설정된 전략에 따라 자동으로 재시도합니다. 최대 재시도 횟수와 각 재시도 간격을 조정하여 재시도 전략을 설정할 수 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>최대 재시도 횟수는 10회입니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>최대 재시도 간격은 5000ms입니다.</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:image {"id":749,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-57-1024x647.png" alt="" class="wp-image-749"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p><strong>오류 처리</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>HTTP 노드는 정보를 처리할 때 네트워크 요청 시간 초과나 요청 제한과 같은 예외 상황에 직면할 수 있습니다. 애플리케이션 개발자는 다음 단계에 따라 실패 분기를 구성하여 노드에서 예외 발생 시 비상 계획을 실행하고 워크플로 중단을 방지할 수 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list {"ordered":true} -->
<ol class="wp-block-list"><!-- wp:list-item -->
<li>HTTP 노드에서 “오류 처리”를 활성화합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>오류 처리 전략 선택 및 구성</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:image {"id":750,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-58-1024x1005.png" alt="" class="wp-image-750"/></figure>
<!-- /wp:image -->