---
title: 获取流程
description: GET /v1/processes/{id}，读取流程及其结果、Human Token 和该人员的情报。
canonical: https://developer.unico.io/zh-CN/human-plugin/api-reference/get-process
locale: zh-CN
generated_by: markdown-export
---

# 获取流程

使用创建流程时 Human Plugin 返回的 id 读取流程。

`GET /v1/processes/{id}`

`id` 是创建响应中的 UUID。该请求没有认证头，也没有按客户端划分的范围限制：任何能够访问 Human Plugin 的调用方都可以读取其中的任何流程。

```bash
curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801
```

## 结果何时返回

- **待处理**的流程（`PROCESS_STATE_CREATED`）会在每次读取时被检查，一旦有结果就立即返回结果。
- **已完成**或**已失败**的流程是最终状态，按原样返回。
- 被中断的创建请求会在启动约 70 秒后按失败返回。

读取是待处理流程推进的唯一方式：没有后台任务，并且返回到您的 `callbackUri` 也不会更新 Human Plugin。

## 响应

`200 OK`，结构与创建响应相同：`id`、`state` 和 `data`。

待处理的 Journey：

```json
{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }
```

<a id="finished-and-failed-processes"></a>

### 已完成和已失败的流程

已完成的流程会在 `data` 中返回其结果：在 `humanToken` 中给出此人是谁，在 `ndocs` 中给出此人的[情报](/zh-CN/human-plugin/get-started/intelligence)；如果流程检查活体，还会返回 `liveness`。重新验证返回 `humanTokenMatch`，而不是 `humanToken`。每个字段都在 [`data` 中的结果](/zh-CN/human-plugin/api-reference/create-process#result)中说明。已失败的流程返回 `PROCESS_STATE_FAILED`，且 `data` 为空。

已完成的流程：

```json
{
  "id": "b063041c-7529-4e70-a2b4-c71c00f19801",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanToken": { "value": "6d3d71…", "status": "validated" },
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 3,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-03",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}
```

已完成的重新验证，其中 `ndocs` 描述的是您所确认的那个人：

```json
{
  "id": "7f2c9a10-3d4e-4b5f-8a61-0c9e2d7b4a35",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanTokenMatch": "true",
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 4,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-04",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}
```

已失败的流程：

```json
{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }
```

Journey 的 `token` 和 `link` 仅在创建时返回，请从该响应中保存。

## 错误

| 状态码 | `message` | 含义 |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | id 不是 UUID 或未知 |
| 502 | `UPSTREAM_UNAVAILABLE` | 流程处于待处理状态，且无法检查其结果。请稍后重试 |
| 503 | `DATABASE_UNAVAILABLE` | 数据库故障。请稍后重试 |

读取可以安全重试。

## 下一步

[获取自拍照](/zh-CN/human-plugin/api-reference/get-selfie)