---
title: Unity 웹 요청 API 소개
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/scripting/object-oriented-development/web-request/intro
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/object-oriented-development/web-request/intro.md
generated_at: 2026-11-19T13:51:48.950Z
locale: ko-kr
---

# Unity 웹 요청 API 소개

> Unity 웹 요청 API의 주요 용도 및 아키텍처를 이해합니다.

`UnityWebRequest`는 Unity의 HTTP/HTTPS 네트워킹 API로, 런타임 시 웹 서비스와 통신하고 파일을 전송하고 스트리밍 데이터를 전송합니다.

Unity 웹 요청 시스템의 일반적인 용도는 다음과 같습니다.

* 런타임 시 콘텐츠 다운로드(예:

  * 일반 [에셋 번들](/engine/6000.0/manual/assets-and-media/assets-managing-runtime/assetbundles-section.md) 또는 [Adressables](https://docs.unity3d.com/Packages/com.unity.addressables@latest) 시스템을 사용할 때 원격 서버의 에셋 번들.
  * 구성, Localization 및 라이브 튜닝을 위한 텍스트/JSON.
  * 동적 콘텐츠를 위한 이미지([텍스처로](/engine/6000.0/manual/materials-and-shaders/textures/textures-getting-started/textures.md)) 및 오디오([오디오 클립으로](/engine/6000.0/manual/audio/reference/class-audio-clip.md))
  * 원격 매니페스트를 통한 빌드 타임 또는 런타임 패치 적용

* 서버에 데이터 업로드(예:

  * 플레이어 지표입니다.
  * 저장된 게임 상태.
  * 오류/예외 로그 및 크래시 리포트
  * 맞춤형 텔레메트리 및 Analytics

* 컨텐츠 전송 네트워크, Authentication 및 보안, 결제 플랫폼, Multiplayer Services, 진단 및 원격 빌드 파이프라인과의 통합

* 낮은 트래픽의 네트워크 Multiplayer 및 턴제 게임(예: 체스)을 구현합니다.

## 아키텍처##architecture

Unity 웹 요청 시스템은 두 개의 레이어로 구성됩니다.

* [고수준 API](/engine/6000.0/manual/scripting/object-oriented-development/web-request/hlapi.md)(HLAPI)는 저수준 API를 래핑하고 일반적인 작업을 위한 편리한 인터페이스를 제공합니다.
* [로우레벨 API](/engine/6000.0/manual/scripting/object-oriented-development/web-request/llapi.md)(LLAPI)는 보다 고급 작업을 위한 최대의 유연성을 제공합니다.

시스템은 HTTP 거래를 다음 작업으로 분류합니다.

* 서버에 데이터 전송.
* 서버에서 데이터를 수신합니다.
* HTTP 플로 제어(예: 리디렉션 및 오류 처리)

각 작업은 특정 타입의 오브젝트에 의해 관리되며, 이를 사용하여 거래의 요소를 커스터마이즈하고 제어할 수 있습니다.

* [`UploadHandler`](/engine/6000.0/script-reference/unityengine/networking/uploadhandler.md) 객체는 서버로의 데이터 전송을 처리합니다.
* 서버에서 수신한 데이터의 수신, 버퍼링 및 포스트 프로세싱을 처리하는 [`DownloadHandler`](/engine/6000.0/script-reference/unityengine/networking/downloadhandler.md) 객체입니다.
* [`UnityWebRequest`](/engine/6000.0/script-reference/unityengine/networking/unitywebrequest.md) 객체는 다른 두 개의 객체를 관리하고 HTTP 플로 제어도 처리합니다. 이 오브젝트는 커스텀 헤더와 URL이 정의되고 오류 및 리디렉트 정보가 저장되는 곳입니다.


**Data sent from user code passes through an UploadHandler and then a UnityWebRequest before reaching the HTTP web server. Data received from the server passes through a UnityWebRequest and then a DownloadHandler before reaching user code.:**
![](/api/media?file=/engine/6000.0/media/images/UnityWebRequestArchitecture.png)

다음은 HTTP 거래의 개요입니다.

* [](/engine/6000.0/script-reference/unityengine/networking/unitywebrequest.md) 오브젝트를 만듭니다.

* `UnityWebRequest` 객체를 구성합니다.

  * 커스텀 헤더를 설정합니다.
  * HTTP 동사 설정(예: `GET`, `POST`, `HEAD` - 모든 플랫폼에서 사용자 지정 동사 사용 가능).
  * URL 설정합니다.

* (선택 사항) 업로드 핸들러를 생성하고 웹 요청에 연결합니다.

  * 업로드할 데이터를 제공합니다.
  * 업로드할 HTTP 양식을 제공합니다.

* (선택 사항) 다운로드 핸들러를 생성하여 웹 요청에 연결합니다.

* 웹 요청을 보냅니다.
  * [코루틴](/engine/6000.0/manual/scripting/object-oriented-development/coroutines-section.md)에서 요청이 완료될 때까지 기다리는 [`UnityWebRequest.SendRequest`](ScriptRef:Networking.UnityWebRequest.SendRequest) 호출 결과를 `yield`할 수 있습니다.

* (선택 사항) 다운로드 핸들러에서 수신한 데이터를 읽습니다.

* (선택 사항) 오류 정보, HTTP 상태 코드 및 `UnityWebRequest` 객체의 응답 헤더를 읽습니다.

이러한 단계를 설명하는 자세한 코드 예시는 [`UploadHandlerRaw`](/engine/6000.0/script-reference/unityengine/networking/uploadhandlerraw.md)에 대한 API 문서를 참조하십시오.

## 추가 리소스##additional-resources

* [웹 요청 고수준 API 레퍼런스](/engine/6000.0/manual/scripting/object-oriented-development/web-request/hlapi.md)
* [웹 요청 저수준 API 레퍼런스](/engine/6000.0/manual/scripting/object-oriented-development/web-request/llapi.md)
