---
title: セルフィーの取得
description: 検証ジャーニー中にキャプチャされた透かし入りのセルフィーを取得します。
canonical: https://developer.unico.io/ja/developers/api-reference/get-selfie
locale: ja
generated_by: markdown-export
---

- [/ja/](/ja/)
- API リファレンス
- セルフィーの取得

**このページの内容# セルフィーの取得

Unicoがホストするジャーニー中にユーザーによってキャプチャされた生体認証セルフィーを返します。画像は透かしが適用されたBase64エンコード文字列として返されます。
生体認証キャプチャを実行した、完了済みのすべてのプロセスで利用可能です。スマート再検証ジャーニー（`idsmart`）も含まれます。生体認証キャプチャなしでプロセスが完了した場合（サイレント認証など）は利用できません。返却するセルフィーが存在しないためです。
### エンドポイント​

環境URL**本番**`GET https://api.idcloud.unico.app/client/v1/process/{processId}/selfie`**サンドボックス**`GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/selfie`
### リクエスト​

ヘッダー
ヘッダー値`Authorization``Bearer <access_token>`（[認証](/ja/developers/start/authentication)を参照）
パスパラメータ
パラメータ型必須説明`processId`string (UUID)はい[プロセスの作成](/ja/developers/api-reference/post-processes)が返すプロセス識別子。
### 例​

cURLNode.js```
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \  -H "Authorization: Bearer $TOKEN"
```

```
import fetch from 'node-fetch';const res = await fetch(  `https://api.idcloud.unico.app/client/v1/process/${processId}/selfie`,  { headers: { Authorization: `Bearer ${accessToken}` } });const { fileContents, contentType } = await res.json();// fileContentsはBase64エンコードされた画像文字列です
```

### レスポンス​

200 OK
```
{  "fileContents": "/9j/4AAQSkZJR...",  "contentType": "image/jpeg"}
```

フィールド型説明`fileContents`string (base64)Base64エンコードされたキャプチャ済みセルフィー。透かしを含みます。`contentType`string画像のMIMEタイプ — `image/jpeg` または `image/png`。
### エラーコード​

メモこのエンドポイントでは、特定の `code` や `message` の値は返されません。
400 Bad Request401 Unauthorized403 Forbidden404 Not Found`processId` パスパラメータが欠落しているか、不正な形式です。Bearerトークンが欠落している、期限切れ、または無効です。[認証](/ja/developers/start/authentication)を参照してください。このプロセスのセルフィーにアクセスする権限が不足しています。プロセスが見つからないか、生体認証キャプチャなしでプロセスが完了したため、返却するセルフィーがありません。
### 次のステップ​

完全なプロセス結果については、[プロセスの取得](/ja/developers/api-reference/get-process)を参照してください。
証跡監査バンドルについては、[証跡セットの取得](/ja/developers/api-reference/get-evidence-set)を参照してください。
最終更新 2026年10月8日**に