> For the complete documentation index, see [llms.txt](https://growingio.gitbook.io/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://growingio.gitbook.io/v3/developer-manual/api-reference/originaldata-export-v2/definition/eventtype.md).

# 获取不同类型原始数据下载链接

## URL

<https://www.growingio.com/v2/insights/{export_type}/{data_type}/{ai}/{export_date}.json?expire={minutes}>

## 请求类型

GET

## 请求头部

公共头部请参考[公共请求头参数](/v3/developer-manual/api-reference/authenticate.md)。

## 参数说明与示例

{% tabs %}
{% tab title="请求参数" %}

| 路径参数 | 类型 | 是否必传 | 说明 |
| ---- | -- | ---- | -- |

| export\_type | string | 是 | 导出任务类型，系统目前支持小时与天的导出，可选值：hour 或者 day |
| ------------ | ------ | - | ------------------------------------ |

| data\_type | string | 是 | <p>导出事件类型，系统支持以下事件类型的导出，可选值：</p><ul><li>visit: 访问事件</li><li>page: 页面事件</li><li>action: 动作事件，包括点击、修改等动作</li><li>action\_tag: 动作事件与圈选规则关联关系</li><li>custom\_event: 自定义事件</li><li>ads\_track\_activation: 广告激活事件</li><li>ads\_track\_click: 广告点击事件</li><li>pvar:页面级变量</li><li>evar: 转化变量</li><li>vstr：访问用户变量</li></ul> |
| ---------- | ------ | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

| ai | string | 是 | 项目ID。 |
| -- | ------ | - | ----- |

| export\_date | string | 是 | <p>导出数据北京时间，格式为 yyyyMMddHHmm, 表现请求导出哪段时间内的数据，分为以下情况：</p><ul><li>当 export\_type 为 day 时，只会截取 export\_date 中 yyyyMMdd, 其余将忽略。</li><li>当 export\_type 为 hour 时，只会截取 export\_date 中 yyyyMMddHH, 其余将忽略。</li></ul> |
| ------------ | ------ | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

| 查询参数 | 类型 | 是否必传 | 说明 |
| ---- | -- | ---- | -- |

| expire       | integer | 否 | <p>下载链接失效时间，单位为分钟。最长时间为7天。</p><p>默认值：5</p> |
| ------------ | ------- | - | ------------------------------------------ |
| {% endtab %} |         |   |                                            |

{% tab title="返回参数" %}

| 名称 | 说明 |
| -- | -- |

| status | <p>导出状态。可能值为：</p><ul><li>FINISHED：导出任务完成，客户可以使用 downloadLinks 中的链接进行文件下载。</li><li>RUNNING：导出任务正在运行。</li><li>NOT\_EXISTS：导出任务不存在，请检查是否开启了导出功能并检查请求日期时间。</li><li>ERROR：导出任务发生错误。</li></ul> |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

| downloadLinks | <p>文件下载链接。</p><p>链接可能随时调整，不应使用链接中的任何内容作为处理程序依据，链接过期时间默认为5分钟。</p> |
| ------------- | ---------------------------------------------------------------- |

| exportType | 表示导出任务类型，由用户传入，服务器原样返回。 |
| ---------- | ----------------------- |

| dataType | 表示导出事件类型，由用户传入，服务器原样返回。 |
| -------- | ----------------------- |

| exportDate | 表示导出数据时间，由用户传入，服务器根据 exportType 截取后返回。 |
| ---------- | -------------------------------------- |

| exportVersion | 表示导出数据版本，当前版本下默认为 v2。 |
| ------------- | --------------------- |

| requestTime | 客户请求发生时服务器时间。 |
| ----------- | ------------- |

| errorMsg     | 请求发生错误时，服务器返回的错误信息。 |
| ------------ | ------------------- |
| {% endtab %} |                     |

{% tab title="响应示例" %}

<pre><code>// 如果下载的是页面级变量数据， pvar 中数据是通过埋点代码上报页面级变量数据，不包含通过圈选定义的页面级变量
<strong>{
</strong>  "status": "",
  "downloadLinks": [],
  "exportType": "",
  "dataType": "",
  "exportDate": "",
  "exportVersion": "",
  "requestTime": "",
  "errorMsg": ""
}
</code></pre>

{% endtab %}
{% endtabs %}
