セルフィーの取得

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。

400 Bad Request

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

401 Unauthorized

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

403 Forbidden

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

404 Not Found

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

エラーコード

メモ

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

400 Bad Request

このステータスに対して特定の code または message 値は記載されていません。

401 Unauthorized

このステータスに対して特定の code または message 値は記載されていません。

403 Forbidden

このステータスに対して特定の code または message 値は記載されていません。

404 Not Found

このステータスに対して特定の code または message 値は記載されていません。

次のステップ

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