---
title: 事件类型
description: IDCloud Webhook 事件类型参考 — 流程完成、失败及状态变更负载说明。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/webhooks-and-events/event-types
locale: zh-CN
generated_by: markdown-export
---

Webhook 负载描述了流程状态的转换。本页记录了负载结构及 `lastEvent` 值的完整枚举。

### 负载结构

| 字段 | 类型 | 描述 |
|---|---|---|
| `processId` | `string` (UUID) | 交易的 ID。 |
| `state` | `string` | 交易的当前状态。目前为：`PROCESS_STATE_FINISHED`。 |
| `flow` | `string` | 本次交易所执行的流程（例如 `id`、`idtoken`）。 |
| `lastEvent` | `string` | 交易的最后事件。**仅在用户完成该流程前已过期时返回。** |
| `lastEventDescription` | `string` | `lastEvent` 的人类可读描述。**仅在用户完成该流程前已过期时返回。** |

:::note[状态词汇表]
Webhook 负载中的 `state` 字段使用 `PROCESS_STATE_*` 前缀。这与 GetProcess 端点返回的 `result` 和 `status` 字段所使用的 `PROCESS_RESULT_*` 词汇体系不同。请勿将两者互换使用。
:::

### 负载示例

#### 已完成 — 成功

```json
{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "id"
}
```

#### 已完成 — 已过期

```json
{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "id",
  "lastEvent": "EVENT_TYPE_SESSION_ENDED",
  "lastEventDescription": "Session ended by timeout or by new session created"
}
```

### lastEvent 枚举

`lastEvent` 中可能出现的完整值列表：

| 事件 | 描述 |
|---|---|
| `EVENT_TYPE_PROCESS_CREATED` | 流程已创建 |
| `EVENT_TYPE_QR_CODE_READ` | 二维码已扫描 |
| `EVENT_TYPE_PROCESS_STARTED_BY_USER` | 用户已启动流程 |
| `EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED` | 身份验证步骤已完成 |
| `EVENT_TYPE_DOCUMENT_STEP_STARTED` | 文件步骤已开始 |
| `EVENT_TYPE_DOCUMENT_PHOTO_CAPTURED` | 文件照片已拍摄 |
| `EVENT_TYPE_DOCUMENT_UPLOADED_FROM_GALLERY` | 文件已从相册上传 |
| `EVENT_TYPE_DOCUMENT_STEP_FINISHED` | 文件步骤已完成 |
| `EVENT_TYPE_SESSION_ENDED` | 会话因超时或新会话创建而结束 |
| `EVENT_TYPE_ERROR_ON_DOCUMENT_STEP` | 文件步骤发生错误 |

:::secondary[可配置处理]
事件集合可能会演变。请将您的端点所响应的事件视为**配置项**，而非硬编码常量——这样在启用新事件时无需重新部署。
:::

### 读取完整流程结果

Webhook 负载表明流程已完成，但并不包含结果本身。要获取结果——以及采集数据、生物特征分数、文件字段等——请调用相应的 **GetProcess** 端点：

- 对于可视化 / Web 与原生流程：参见 [API 参考 > Web 与原生 > GET /v1/process/{id}](/dual-api/developers/api-reference/web-sdk)。
- 对于非可视化 / API 流程：参见 [API 参考 > API > GET /processes/v1/{id}](/dual-api/developers/api-reference/api)。