---
title: 获取自拍照
description: GET /v1/processes/{id}/selfie，读取流程中采集的自拍照、其可用时长以及相关错误。
canonical: https://developer.unico.io/zh-CN/human-plugin/api-reference/get-selfie
locale: zh-CN
generated_by: markdown-export
---

# 获取自拍照

使用创建流程时 Human Plugin 返回的 id，读取该流程中采集的自拍照。

`GET /v1/processes/{id}/selfie`

`id` 是创建响应中的 UUID。该请求没有请求体，也没有查询参数。

```bash
curl http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie
```

Human Plugin 不会保留自拍照的副本：每次调用都会重新获取。

## 响应

`200 OK`，返回 base64 格式的图像及其类型：

```json
{
  "fileContents": "/9j/4AAQSkZJRgABAQAAAQABAAD…",
  "contentType": "image/jpeg"
}
```

将其保存为文件：

```bash
curl -s http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie \
  | jq -r .fileContents | base64 -d > selfie.jpg
```

## 可用性

- 只有确实有自拍照的流程才有自拍照：通过 `imageBase64` 发送，或从此人处采集。
- 对于 Journey 流程，只有在此人完成采集之后才会有自拍照。在此之前，请求会被以 `400` 拒绝，且 `message` 以 `process state must be finished` 开头。请先[读取流程](/zh-CN/human-plugin/api-reference/get-process)，待其变为 `PROCESS_STATE_FINISHED` 后再获取自拍照。
- 自拍照在流程完成后的有限时间内可用。如果之后还需要使用，请从该响应中自行存储。

## 处理图像

自拍照属于生物识别数据。Human Plugin 从不存储或记录它，并且响应以 `Cache-Control: no-store` 发送。也请不要让它出现在您的网关和应用程序日志中。

## 错误

| 状态码 | `message` | 含义 |
| --- | --- | --- |
| 400 | `process state must be finished…` | Journey 流程的采集尚未完成。请先读取该流程 |
| 404 | `PROCESS_NOT_FOUND` | id 不是 UUID 或未知 |
| 404 | `SELFIE_NOT_FOUND` | 该流程没有自拍照：未进行采集、在开始之前就已失败，或自拍照已不再可用 |
| 4xx | 拒绝原因 `message` | 请求被拒绝。原因见 `message` 和 `details` |
| 502 | `UPSTREAM_UNAVAILABLE` | 未能及时获取自拍照。请稍后重试 |
| 503 | `DATABASE_UNAVAILABLE` | 数据库故障。请稍后重试 |

读取可以安全重试。`404` 不会因重试而改变。

## 下一步

[流程生命周期](/zh-CN/human-plugin/api-reference/process-lifecycle)