# UDP API

> Reference for the Unity Distribution Portal API, a service that shut down in February 2025.

| **중요**                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UDP(유니티 퍼블리싱 포털)는 2025년 2월 17일에 종료됩니다. UDP 웹 콘솔 및 서비스에 대한 액세스는 이 날짜에 영구적으로 비활성화됩니다. 키스토어를 다운로드하고 게임을 앱 스토어에 직접 다시 퍼블리시하는 방법에 대한 지침을 보려면 [UDP 개요](https://api-udp.unity.com/overview) 페이지를 방문하십시오. 계정에 대한 질문이 있으면 [Unity 고객 지원 팀](https://support.unity.com/hc/en-us/requests/new?ticket_form_id=360000323692)에 티켓을 제출하십시오. |

UDP API를 사용하면 UDP 콘솔에 바이너리 파일을 업로드할 수 있습니다. 이를 통해 CI 시스템을 사용하여 앱을 빌드하고 출력을 UDP로 직접 푸시할 수 있습니다. [UDP 콘솔에서 게임 관리 및 퍼블리싱](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md#api-upload)을 참조하십시오.

다음 파일 유형이 지원됩니다.

* APK
* OBB
* AAB

## API 구조

API는 다음과 같이 구성됩니다. \[[https://distribute.dashboard.unity.com/developer/api/upload/:orgId/:clientId?token=xxxxxx](https://distribute.dashboard.unity.com/developer/api/upload/:orgId/:clientId?token=xxxxxx)[\&obbType=xxxx](https://distribute.dashboard.unity.com/developer/api/upload/:orgId/:clientId?token=xxxxxx%5B\&obbType=xxxx)]

아래 표에는 API 파라미터에 대한 설명이 나와 있습니다.

| 파라미터       | 설명                                                                                               |
| ---------- | ------------------------------------------------------------------------------------------------ |
| `orgId`    | 바이너리 파일을 업로드할 게임의 조직 ID입니다.                                                                      |
| `clientId` | 바이너리 파일을 업로드할 게임의 클라이언트 ID입니다.                                                                   |
| `token`    | UDP 콘솔의 개발자 API 페이지에서 생성된 인증 토큰입니다.                                                              |
| `obbType`  | 업로드하려는 OBB 파일 유형입니다. 다음 문자열 값은 유효합니다.- `mainObb`- `patchObb`OBB 파일을 업로드할 때만 이 쿼리 파라미터를 지정해야 합니다. |

## 폼 키

POST 메서드에서 폼 키를 사용하여 빌드를 UDP에 업로드할 때 값을 지정할 수 있습니다. 값은 Game Information 탭의 Binary 섹션에 해당합니다.

아래 표에는 폼 키에 대한 설명이 나와 있습니다.

| 폼 키                | 설명                                                                | 필수/선택 |
| ------------------ | ----------------------------------------------------------------- | ----- |
| `uploadFile`       | 업로드할 파일의 경로를 지정합니다.                                               | 필수    |
| `whatsNew`         | UDP 콘솔의 **What’s New** 필드 값을 설정합니다.                               | 선택    |
| `useGoogleService` | UDP 콘솔의 **Does your game use Google Play Services?** 필드 값을 설정합니다. | 선택    |

선택 키를 지정하지 않으면 UDP가 게임의 최신 버전의 값을 사용합니다.

## 일반적인 오류 메시지 및 오류 코드

### 잘못된 인증 토큰

잘못된 인증 토큰을 제공하면 상태 코드가 401인 오류 메시지가 표시됩니다.

```
{"errorCode":"NotAuthenticated","message":"not authenticated error","target":"","details":null}
```

### 잘못된 조직 ID 또는 클라이언트 ID

잘못된 조직 ID나 잘못된 클라이언트 ID를 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.

```
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"Invalid OrgId or ClientId","details":null}
```

### 잘못된 파일 유형

잘못된 파일 유형을 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.

```
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid: please provide the right binary file(APK, AAB or OBB)","target":"file type","details":null}
```

### 잘못된 OBB 유형

잘못된 OBB 유형을 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.

```
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"obbType","details":null}
```

### 잘못된 콘텐츠 유형

잘못된 콘텐츠 유형을 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.

```
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"content type","details":null}
```