セルフィーの取得

Unico がホストするジャーニー中にユーザーによってキャプチャされた生体認証セルフィーを返します。画像は透かしが適用された base64 エンコード文字列として返されます。

生体認証キャプチャを実行したプロセス（Liveness または Identity Verification を含む任意のフロー）でのみ利用可能です。Smart Revalidation フロー（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>（認証を参照）

パスパラメーター

パラメーター	型	必須	説明
processId	string (UUID)	はい	プロセス作成で返されたプロセス識別子。

例

cURL

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

Node.js

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 is a base64-encoded image string

レスポンス

200 OK

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

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

エラーコード

メモ

API はこのエンドポイントに対して特定の code または message 値を公開していません。

400 Bad Request

processId パスパラメーターが欠落しているか、不正な形式です。

401 Unauthorized

Bearer トークンが欠落、期限切れ、または無効です。認証を参照してください。

403 Forbidden

このプロセスのセルフィーにアクセスする権限が不足しています。

404 Not Found

プロセスが見つからないか、このプロセスでセルフィーが利用できません（例: Smart Revalidation フロー）。

次のステップ

• プロセスの全結果については、プロセスの取得を参照してください。
• 証拠監査バンドルについては、エビデンスセットの取得を参照してください。