# 应用信息查询

> 来源：https://help.gravity-engine.com/docs/server-integration/other-apis/app-info
> 说明如何通过 Gravity Engine OpenAPI 查询应用名称、包名等应用信息，包括认证、请求参数与返回字段。



此接口用于查询引力后台应用信息，包括应用包名、应用名称等。

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

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

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

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

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

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

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

POST

### Header [#header]

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

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

| 参数名            | 必填 | 类型      | 说明     | 描述                                                                             |
| -------------- | -- | ------- | ------ | ------------------------------------------------------------------------------ |
| `os`           | N  | int     | 应用类型   | 取值参考 [产品类型枚举值](/docs/appendix/product-type-enums)                              |
| `is_enabled`   | N  | boolean | 应用是否启用 | 应用投放状态                                                                         |
| `project_id`   | N  | int     | 项目ID   | 在[【引力后台-设置-应用管理】](https://web.gravity-engine.com/#/manage/appmanage?type=1)处获取 |
| `name`         | N  | string  | 应用名称   | 根据应用名称模糊查询                                                                     |
| `package_name` | 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/list/' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfa2V5IjoiYmY5YjNhZjU2ZDNkNGM5ZDkyZtFhYmNlMDYxMGQwNWQifQ.iegV82qM8io5ouWTK0yIFHSIa9sImZZS5KARV_FkcnE' \
--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 '{
    "os":0,
    "is_enabled": true,
    "sign":"9775ff35aacaae9acd51190f7c3a3b64"
}'
```

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

```json
{
    "data": [
        {
            "id": 20283794,
            "name": "iOS（预置2月数据）",
            "is_enabled": true,
            "os": 0,
            "package_name": "com.miniworldroyale.sparkgame"
        },
        {
            "id": 21627948,
            "name": "111",
            "is_enabled": true,
            "os": 0,
            "package_name": "111111"
        },
        {
            "id": 26519034,
            "name": "3dfsf444erd433",
            "is_enabled": true,
            "os": 0,
            "package_name": "33tgfdg3sdfdsf3"
        }
    ],
    "extra": {
        "error": "",
        "request_id": "b7ffba110d274388861754880308c7c0"
    },
    "code": 0,
    "msg": "成功"
}
```