---
title: 获取流程
description: 通过标识符检索现有的 API 合约流程。由于结果已在创建时同步返回，此接口用于重新查询。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/api-reference/api/get-process
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- [API 参考](/zh-CN/dual-api/developers/api-reference/)
- [API](/zh-CN/dual-api/developers/api-reference/api/)
- 获取流程

**本页内容获取流程GET通过标识符检索已有流程。根据 API 合约，结果已在流程创建时同步返回——请将此端点用于重新查询、审计和支持场景。

警告在获取流程之前，请查看我们的 webhook 配置和回退策略 — [点击此处](/zh-CN/developers/webhooks-and-events/setup)。
### 端点​

环境URL**生产环境**`GET https://api.id.unico.app/processes/v1/{processId}`**沙箱环境**`GET https://api.id.uat.unico.app/processes/v1/{processId}`
### 请求​

请求头
请求头值`Authorization``Bearer <access_token>``APIKEY`已配置的 API 密钥。
路径参数
参数类型必填描述`processId`string (UUID)是由[创建流程](/zh-CN/dual-api/developers/api-reference/api/post-processes)返回的流程标识符。
### 示例​

cURLNode.js```
curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \  -H "Authorization: Bearer $TOKEN" \  -H "APIKEY: $API_KEY"
```

```
import fetch from 'node-fetch';const res = await fetch(  `https://api.id.unico.app/processes/v1/${processId}`,  {    headers: {      Authorization: `Bearer ${accessToken}`,      APIKEY: apiKey    }  });const result = await res.json();
```

### 响应​

200 OK
该合约是统一的——`idCloud.result` 字段承载了所用功能的整合判定结果。
Unico 将已执行功能的结果整合为单一的 `idCloud.result`，可直接用于决定您流程的下一步——无需自行编排各项结果。
```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "idCloud": {    "result": "approved"  }}
```

字段类型描述`id`string (UUID)流程标识符。`status`integer`1`（处理中）、`2`（差异）、`3`（成功完成）、`4`（已取消）、`5`（错误）。
可能的结果值
idCloud.result含义建议操作approved真实人员且身份已验证。继续该流程。denied身份未验证、活体检测失败，或识别到极端风险。结束该流程或跳转至备用流程。critical-risk识别到严重风险级别。结束该流程或转至人工审核。high-risk识别到高风险级别。转至人工审核或备用流程。retry采集数据或评分不足，无法评估。请用户重新进行采集。inconclusive证据不足，无法做出判定。转至人工审核或备用流程。
返回的值取决于您 APIKey 中配置的配方。各配方可返回的结果值请参见[流程](/zh-CN/dual-api/developers/api-reference/api/flows)。
巴西的客户可能会按功能接收响应整体响应结构保持不变——单一结果为默认方式。巴西的集成可能会收到开放式的、按功能划分的结果。APIKey 中启用的每项功能都会在响应中新增相应的字段块——未启用功能的字段则会被省略。```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "unicoId": {    "result": "yes"  },  "riskLevel": {    "result": "inconclusive"  },  "idFace": {    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",    "result": "FOUND"  },  "identityFraudsters": {    "result": "inconclusive"  },  "government": {    "serpro": 87  },  "liveness": 1,  "idAge": {    "result": "yes"  },  "cardholderVerification": {    "result": "approved"  }}
```

字段类型描述`unicoId.result`string`yes`、`no`、`inconclusive` — 参见[身份验证](/zh-CN/capabilities/identity-verification)。`riskLevel.result`string`not_approved`、`critical_risk`、`high_risk`、`inconclusive` — 参见[欺诈风险分类](/zh-CN/capabilities/fraud-risk-classification)。`idFace.result`string`FOUND` — 参见人脸标识符。`idFace.personId`string人脸的稳定不透明标识符，与 `idFace.result = FOUND` 一同返回。当图像中无法识别出人脸时，流程会返回错误 `20532`，而不是 `idFace` 字段块。`identityFraudsters.result`string**已弃用。** 请改用 `riskLevel`。仍在进行集成的客户可在与项目团队协调迁移工作的同时继续使用此字段。`government.serpro`integerSerpro 相似度分数（0–100、-1、-2）。仅在巴西可用。参见 [Serpro 相似度返回](/zh-CN/capabilities/serpro-similarity-return)。`liveness`integer`1`（通过）、`2`（未通过） — 参见[活体检测](/zh-CN/capabilities/liveness)。`idAge.result`string`yes`、`no`、`inconclusive` — 参见[年龄验证](/zh-CN/capabilities/age-verification)。仅在巴西可用。`score`integer概率性风险评分。当 `unicoId.result = inconclusive` 且风险评分编排处于活动状态时出现。正值表示持有人身份的可能性更高；负值表示风险更高。仅在巴西可用。`cardholderVerification.result`string`approved`、`unsure` — 参见 [Cardholder Verification](/zh-CN/capabilities/cardholder-verification)。当 `status` 尚未达到 `3`（完成）时不存在此字段。仅在巴西可用。
墨西哥的客户可能会收到 RENAPO Verification 块响应结构保持不变，并新增 idGov 块。在墨西哥启用了 RENAPO Verification 的集成，会额外收到一个 idGov 块，其中包含 RENAPO 为用户 CURP 所持有的记录。它是与身份结果相互独立的答复。```
{  "id": "11111111-2222-3333-4444-555555555555",  "status": 3,  "idCloud": { "result": "approved" },  "idGov": {    "government_valid": true,    "curp": "PUEA880304MDFRJN04",    "government_name": "ANA PRUEBA EJEMPLO",    "date_of_birth": "1988-03-04",    "age": 38,    "gender": "F",    "deceased": false,    "is_mexican": true,    "citizenship": "MEXICO",    "state_of_birth": "Ciudad de México",    "state_iso": "MX-CMX",    "issuing_entity_code": "DF",    "municipality_registration": ""  }}
```

字段类型描述`idGov`objectCURP 对应的 RENAPO 记录。未启用该功能时不存在。RENAPO 未响应时为 `{}`。仅限墨西哥。参见 [RENAPO Verification](/zh-CN/capabilities/renapo-verification)。
### 何时使用此端点​

API 合约同步返回结果，因此大多数集成不需要使用此端点。请在以下情况下使用：

您仅持久化了 `processId`，需要稍后检索完整结果（审计、支持场景）。
您怀疑原始响应在传输过程中丢失（平台完成处理后发生网络错误）。
您正在构建用于审查历史流程的后台管理工具。

### 错误代码​

400 Bad Request404 Not Found403 Forbidden410 Gone429 Too Many Requests500 Internal Server Error代码消息描述`20023`O parâmetro processId não foi informado.缺少流程 ID 参数。`20002`O parâmetro APIKey não foi informado.请求头中缺少 APIKEY 参数。`20001`O parâmetro authtoken não foi informado.请求头中缺少集成令牌参数。代码消息描述`50001`O processo informado não foi encontrado. 该流程在数据库中不存在。代码消息描述`30017`User does not have permission to perform this action.JWT 格式错误或用户无权执行此操作。`10502`O token informado está expirado.使用的访问令牌已过期。`10501`O token informado é inválido.认证令牌无效。`10201`O AppKey informado é inválido.APIKEY 参数未输入或不存在。流程存在，但结果为错误。仅返回 `id` 和 `status: 5`。已达到速率限制。当您的系统收到 HTTP 429 错误时，必须实施机制以防止级联故障并避免加重限制。
**最佳实践：**

**冷却期（backoff）：** 立即停止或限制系统的后续请求。不要在紧密循环中持续重试失败的请求。
**排队与限流（Queueing & throttling）：** 在您的一侧缓冲或排队传出请求，以便在重新发送之前控制流量。
**带抖动的指数退避（Exponential backoff with jitter）：** 重试时，在尝试之间以指数方式增加等待时间（例如，1秒、2秒、4秒、8秒），并添加一个小的随机延迟（"抖动"），以防止所有排队请求在完全相同的毫秒重试的羊群效应。

警告在未应用退避的情况下持续请求受速率限制的端点，可能会**延长限制期**并严重影响系统的运行吞吐量。在您的一侧正确限流请求可确保更顺畅、更具弹性的集成。
有关默认限制、增加请求及其他详细信息，请参阅[速率限制](/zh-CN/dual-api/developers/api-reference/rate-limits)。代码消息描述`99999`Internal failure! Try again later出现内部错误时。
### 流程​

配方是项目 APIKey 中配置的功能组合（活体检测、身份验证、风险信号、文档等）。它定义了 Unico 在每个流程中执行的操作，以及如何将结果整合为单一的 `result` —— 您无需在自己一侧进行任何编排。
Unico 维护着一个预设配方目录，每个配方都有名称并进行版本管理（例如 `byunico-idlive-idunico-oneresponse-std`）。其中一些配方仅限巴西使用，例如包含评分、Serpro 或年龄验证的配方。
您的流程运行哪些功能？功能组合——即您项目的流程——由您的 APIKey 配置定义。请查看预设配方，或联系您的 Unico 项目负责人进行定制。最后更新 于 2026年10月8日**