# 애플리케이션 API

> 애플리케이션 API 사용하여 애플리케이션을 생성, 가져오거나 업데이트하거나 삭제하여 AIR 앱의 라이프사이클을 관리할 수 있습니다.

이 API 사용하여 Ironsource 대시보드에서 애플리케이션을 가져오고 생성합니다.

## 앱 가져오기

### Description

이 API 사용하여 모든 앱 목록을 가져옵니다. 응답에는 위 표에 설명된 자세한 파라미터가 포함됩니다.

### Authentication 유형

[Bearer API 인증](/grow/levelplay/platform/api/authentication.md.md)

## 메서드

GET:

```text
platform.ironsrc.com/partners/publisher/applications/v6?
```

필수 파라미터: 없음
요청 예제 URL: [https://platform.ironsrc.com/partners/publisher/applications/v6](https://platform.ironsrc.com/partners/publisher/applications/v6)?

### 파라미터(선택 사항)

응답에서 반환되는 애플리케이션의 양을 줄이려면 다음 파라미터를 추가하여 결과를 필터링합니다.

| **필터 파라미터** | **Description** | **Value**   |
| ----------- | --------------- | ----------- |
| `platform`  | 운영체제            | iOS/Android |
| `appStatus` | 애플리케이션 활성화 상태   | 활성/아카이브됨    |

### 요청 예제 URL

```xml
https://platform.ironsrc.com/partners/publisher/applications/v6?appStatus=active
```

### 응답 파라미터

| **Name**              | **Description**                     |
| --------------------- | ----------------------------------- |
| `appKey`              | 애플리케이션 키(플랫폼에서 확인 가능)               |
| `appName`             | 애플리케이션 이름                           |
| `appStatus`           | 앱 상태가 활성 상태일 수도 있고 비활성 상태일 수도 있습니다. |
| `platform`            | iOS 또는 Android                      |
| `bundleId`            | 스토어 번들 ID                           |
| `trackId`             | 애플리케이션 스토어 트랙 ID(iOS 전용)            |
| `taxonomy`            | 애플리케이션 하위 장르입니다.                    |
| `creationDate`        | 애플리케이션 Ironsource 플랫폼에 추가된 날짜입니다.   |
| `icon`                | 애플리케이션 아이콘(스토어에서 가져오기)              |
| `adUnits`             | 광고 유닛별로 활성 광고 네트워크 이름 포함            |
| `networkReportingApi` | 포함하는 액티브 광고 네트워크의 보고 API 상태         |
| `coppa`               | 애플리케이션 COPPA 설정(true=1/false=0)     |
| `ccpa`                | 애플리케이션 CCPA 설정(true=1/false=0)      |

### JSON 예제 응답

```json
 [
    {
        "appKey": "6be7c3bd",
        "appName": "puzzl2999",
        "appStatus": "active",
        "platform": "Android",
        "bundleId": "unknown",
        "taxonomy": "Bingo",
        "creationDate": "01/01/2020",
        "icon": "https://local.supersonicads.com/ssastatic/partners/assets/images/appDefaultIcon.v3.png",
        "adUnits": {
            "rewardedVideo": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "offerWall": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "interstitial": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "banner": {
                "activeNetworks": [
                    "ironSource"
                ]
            }
        },
        "networkReportingApi": {
            "ironSource": "verified"
        },
        "bundleRefId": 0,
        "coppa": 1,
        "ccpa": 1
    },
    {
        "appKey": "6be7e081",
        "appName": "puzzl2999666",
        "appStatus": "active",
        "platform": "Android",
        "bundleId": "unknown",
        "taxonomy": "Bingo",
        "creationDate": "01/01/2020",
        "icon": "https://local.supersonicads.com/ssastatic/partners/assets/images/appDefaultIcon.v3.png",
        "adUnits": {
            "rewardedVideo": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "offerWall": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "interstitial": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "banner": {
                "activeNetworks": [
                    "ironSource"
                ]
            }
        },
        "networkReportingApi": {
            "ironSource": "verified"
        },
        "bundleRefId": 0,
        "coppa": 1,
        "ccpa": 0
    }
]
```

## Create app

### Description

이 API 사용하여 Ironsource 플랫폼에서 앱을 생성합니다. 앱 생성 API 사용하여 앱을 생성하는 경우, 지원되는 각 광고 유닛(보상형 비디오, 인터스티셜 광고, 배너, 오프터웨일)을 'Off' 상태로 자동으로 생성합니다(다른 요청이 없는 경우).

### Authentication 유형

[Bearer API 인증](/grow/levelplay/platform/api/authentication.md.md)

### 메서드

POST

```text
platform.ironsrc.com/partners/publisher/applications/v6?
```

### 라이브 앱 생성에 필요한 파라미터

| **Name**   | **Type** | **Description**                           |
| ---------- | -------- | ----------------------------------------- |
| `storeUrl` | 문자열      | 앱의 스토어 URL                                |
| `taxonomy` | 문자열      | 애플리케이션 하위 장르입니다.                          |
| `coppa`    | 정수       | 애플리케이션 coppa 상태입니다(true = 1 / false = 0). |

### 스토어에 게재되지 않은 앱을 생성하는 데 필요한 파라미터

| **Name**   | **Type** | **Description**                           |
| ---------- | -------- | ----------------------------------------- |
| `appName`  | 문자열      | 애플리케이션 이름                                 |
| `platform` | 문자열      | iOS 또는 Android                            |
| `coppa`    | 정수       | 애플리케이션 coppa 상태입니다(true = 1 / false = 0). |

### 파라미터(선택 사항)

| **Name**        | **Type** | **Description**                            |
| --------------- | -------- | ------------------------------------------ |
| `adUnit:status` | 문자열      | "RewardedVideo": "Live"                    |
| `ccpa`          | 정수       | 는 애플리케이션 ccpa 상태입니다(true = 1 / false = 0). |

### 요청 예제 URL\*\*

```text
https://platform.ironsrc.com/partners/publisher/applications/v6?
```

### 라이브 앱을 만드는 예제 바디 요청

```json
{
  "storeUrl": "https://apps.apple.com/us/app/time-gap-hidden-objects/id661173158",
  "taxonomy": "puzzle",
  "appName": "puzzleApp",
  "coppa":1,
  "ccpa":0,
  "adUnits": {
    "RewardedVideo": "라이브",
    "Interstitial": "라이브",
    "OfferWall": "끄기",
    "Banner": "라이브",
    "NativeAd": "Live"
  }
}
```

### 스토어에 라이브되지 않은 앱을 만드는 예제 바디 요청

```json
{
 "appName": "MyTestAppiOS",
 "platform": "iOS"
}
```