# 查询导出进度

> 来源：https://help.gravity-engine.com/docs/server-integration/reporting/export-status
> 说明如何通过 Gravity Engine OpenAPI 查询用户行为事件导出任务的进度、结果与失败信息，涵盖认证、请求参数、筛选条件和返回字段。



引力引擎支持使用 `API` 方式直接导出应用内用户行为事件，[导出用户行为事件接口](/docs/server-integration/reporting/export-user-events)会返回导出任务的任务 ID，您可以根据此 ID 查询事件导出任务进度。

在开始对接此接口前，建议您先阅读 [数据规则](/docs/getting-started/data-rules) 章节，在熟悉引力引擎的数据格式与数据规则后，再阅读本指南进行对接。

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

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

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

## 接口限频 [#接口限频]

默认接口限频：每 10 秒 100 次。接口限频按开发者应用维度统计，即同一个 `app_key` 下的应用共用同一套频次限制。如果开发者绑定应用过多导致频繁触发限频，请联系引力运营评估后提升限频等级。

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

### 接口地址 [#接口地址]

```text
https://api.insight.gravity-engine.com/openapi/api/v1/download/event/query_result/
```

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

POST

### 请求参数 [#请求参数]

#### Header 参数 [#header-参数]

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

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

| 字段        | 必填 | 参数类型   | 描述                                                          |
| --------- | -- | ------ | ----------------------------------------------------------- |
| `task_id` | Y  | string | 应用事件导出的任务 ID                                                |
| `sign`    | Y  | string | 签名，详情请参考 [【签名生成】](/docs/server-integration/request-signing) |

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

```bash
curl 'https://api-insight.gravity-engine.com/openapi/api/v1/download/event/query_result/' \
-H 'Content-Type: application/json' \
-H 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfa2V5IjoiMWMyOGU2MDNlNzE2NGNiYWFjZWEwMGU5ODkxNTNhNGQifQ.7ak-9PE9mMK3VPQ0aYkwRxXuP2xFCgqpr6pncC1TMYc' \
-d '{
    "sign": "7507a7a1c8234748b8ccc6198c16fe0e",
    "task_id": "e69217feac324e4eb7c4b9c0a860711a"
}'
```

### 响应参数 [#响应参数]

| 字段             | 描述                                                                                                           |
| -------------- | ------------------------------------------------------------------------------------------------------------ |
| `status`       | 导出作业的状态。取值范围：`running` = 1（处理中）、`succeed` = 2（处理完成）、`failed` = 3（处理失败）、`cancel` = 4（取消下载任务）、`expire` = 5（过期） |
| `progress`     | 任务导出进度。取值范围：0-100                                                                                            |
| `download_url` | 导出文件的下载链接，文件会保存 3 天，3 天后过期删除                                                                                 |

### 响应示例 [#响应示例]

```json
{
    "data": {
        "task_id": "56b98c5a9a774e458db441d7e9885972",
        "status": 2,
        "progress": 100,
        "download_url": "https://gravity-client-resource.oss-cn-hangzhou.aliyuncs.com/264832/excels/事件导出-267493-2025-10-31_12-17-55.csv.gz",
        "message": "{}"
    },
    "extra": null,
    "code": 0,
    "msg": "成功"
}
```