# 创建应用

> 来源：https://help.gravity-engine.com/docs/server-integration/other-apis/create-app
> 说明如何通过 Gravity Engine OpenAPI 创建应用，包括开发者应用准备、认证、请求参数与返回结果。



此接口用于创建引力应用。

## 申请开发者应用 [#申请开发者应用]

在正式接入本接口之前，您需要在引力后台-[引力开发者](https://web.gravity-engine.com/#/manage/develop)页面申请引力开发者应用，申请之后，我们将在一个工作日内完成审核，审核通过之后，您的开发者应用才可以正常拉取数据。

创建好开发者应用之后，请复制 `app_key` 参数，并发送给研发同学以供后续接口调用使用。

## 接口信息 [#接口信息]

### 请求地址 [#请求地址]

```
https://api-insight.gravity-engine.com/openapi/api/v1/open_app/create/
```

### 请求方法 [#请求方法]

POST

### Header [#header]

| 字段            | 类型     | 描述                                                           |
| ------------- | ------ | ------------------------------------------------------------ |
| Authorization | string | 具体如何生成，请参考[【签名生成】](/docs/server-integration/request-signing) |

### body 参数 [#body-参数]

| 参数名                | 必填   | 类型        | 说明          | 描述                                                           |
| ------------------ | ---- | --------- | ----------- | ------------------------------------------------------------ |
| `os`               | Y    | int       | 产品类型        | 枚举值请参考[【产品类型枚举值】](/docs/appendix/product-type-enums)         |
| `name`             | Y    | string    | 应用名称        | 不超过 30 个字符                                                   |
| `icon_url`         | N    | string    | 产品图标        | 如需填写，请使用可访问的远程 URL 图片链接，如 [https://xxx.png](https://xxx.png) |
| `package_name`     | Y    | string    | 包名          | 非小游戏/小程序：请填写包名<br />小游戏/小程序：请填写 APPID                        |
| `sub_package_list` | N    | string\[] | Android 子包名 | Android 选填，其他产品类型不填                                          |
| `wechat_app_id`    | 条件必填 | string    | APPID       | xx 小游戏/xx 小程序、快游戏必填。<br />其他产品类型不填                           |
| `wechat_origin_id` | 条件必填 | string    | 微小原始ID      | **微信小游戏/小程序必填**，请输入以 `gh_` 开头的原始 ID。<br />其他产品类型不填           |
| `industry_id`      | 条件必填 | int       | 行业          | Android 枚举值：游戏-1、电商-2、其他-3。<br />其他产品类型请传入 1                 |
| `is_iaa`           | 条件必填 | int       | 是否 IAA      | 微信小游戏/小程序必填。枚举值：是-1、否-0<br />其他产品类型不填                        |
| `remark`           | N    | string    | 备注          | 备注信息                                                         |
| `sign`             | Y    | string    | 签名          | 详情请参考[【签名生成】](/docs/server-integration/request-signing)      |

### 请求示例 [#请求示例]

```bash
curl --location --request POST 'https://api-insight.gravity-engine.com/openapi/api/v1/open_app/create/' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfa2V5IjoiYmY5YjNhZjU2ZDNkNGM5ZDkyZTFhYmNlMDYxmGQwNWQifQ.nIamPAHCSwThBAwI_cfWAcPRIjoATPvF_2i0VTEn-V0' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Host: api-insight.gravity-engine.com' \
--header 'Connection: keep-alive' \
--data-raw '{
    "name": "your_app_name",
    "wechat_app_id": "wxbbbbb",
    "remark": "",
    "icon_url": "",
    "package_name": "wxbbbbb",
    "os": 6,
    "sign":"11ae8b6872950bc752066503423d01f1"
}'
```

### 应答示例 [#应答示例]

```json
{
  "data": {
    "app": {
      "id": 123,
      "name": "",
      "os": 1,
      "icon_url": "",
      "package_name": "",
      "remark": "",
      "industry_id": 1,
      "wechat_app_id": "",
      "wechat_origin_id": "",
      "is_iaa": 0
    }
  },
  "extra": {
    "error": ""
  },
  "code": 0,
  "msg": "成功"
}
```