# 应用程序 API

> 通过使用应用程序 API 获取、创建、更新或删除应用程序来管理 AIR app 的生命周期。

使用此 API 可在 IronSource 的后台上获取和创建应用程序。

## 获取应用

### 描述

使用此 API 可检索所有应用的列表。响应将包括上表中描述的详细参数

### Authentication类型

[Bearer API 身份验证](/grow/levelplay/platform/api/authentication.md.md)

## 方法

GET：

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

必需参数：None（无）
请求示例网址：[https://platform.ironsrc.com/partners/publisher/applications/v6](https://platform.ironsrc.com/partners/publisher/applications/v6)?

### 可选参数

为了减少响应返回的应用程序数量，请通过添加以下参数来过滤结果：

| **Filter 参数** | **描述**   | **值**       |
| ------------- | -------- | ----------- |
| `platform`    | 操作系统     | iOS/Android |
| `appStatus`   | 应用程序激活状态 | 激活/存档       |

### 请求示例网址

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

### 响应参数

| **Name（名称）**          | **描述**                          |
| --------------------- | ------------------------------- |
| `appKey`              | 应用程序密钥（在我们的平台上显示）               |
| `appName`             | 应用程序名称                          |
| `appStatus`           | app 状态可以是激活或非激活                 |
| `platform`            | iOS 或 Android                   |
| `bundleId`            | Store Bundle 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
    }
]
```

## 创建应用程序

### 描述

使用此 API 可在 ironSource 平台上创建 app。使用 app 创建 API 创建 app 时，除非另有请求，否则我们会在“关闭”状态下自动创建每个受支持的广告单位（奖励视频、插页式广告、横幅广告、优惠墙）。

### Authentication类型

[Bearer API 身份验证](/grow/levelplay/platform/api/authentication.md.md)

### 方法

POST

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

### 创建实时 app 所需的参数

| **Name（名称）** | **类型** | **描述**                               |
| ------------ | ------ | ------------------------------------ |
| `storeUrl`   | 字符串    | app 的商店网址                            |
| `taxonomy`   | 字符串    | 应用程序子类型。                             |
| `coppa`      | 整数     | 应用程序的 COPPA 状态（true = 1 / false = 0） |

### 创建不在应用商店中的 app 所需的参数

| **Name（名称）** | **类型** | **描述**                               |
| ------------ | ------ | ------------------------------------ |
| `appName`    | 字符串    | 应用程序名称                               |
| `platform`   | 字符串    | iOS 或 Android                        |
| `coppa`      | 整数     | 应用程序的 COPPA 状态（true = 1 / false = 0） |

### 可选参数

| **Name（名称）**    | **类型** | **描述**                              |
| --------------- | ------ | ----------------------------------- |
| `adUnit:status` | 字符串    | “RewardedVideo”："Live"              |
| `ccpa`          | 整数     | 应用程序的 ccpa 状态（true = 1 / false = 0） |

### 请求示例网址\*\*

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

### 请求用于创建实时 app 的示例正文

```json
{
  "storeUrl": "https://apps.apple.com/us/app/time-gap-hidden-objects/id661173158",
  "taxonomy": "puzzle",
  "appName": "puzzleApp",
  "coppa":1,
  "ccpa":0,
  "adUnits": {
    “RewardedVideo”："Live",
    "Interstitial":"Live",
    "OfferWall":“关闭”，
    “横幅”："Live",
    "NativeAd":"Live"
  }
}
```

### 请求示例正文以创建不在应用商店中的 app

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