証拠セットの取得

生体キャプチャ中に生成された証拠バンドルを返します — キャプチャされた画像、メタデータ、および制御された条件下で活性検知が実施されたことを証明するために使用されるキャプチャアーティファクトを含むパッケージです。

完了済みプロセス（state = PROCESS_STATE_FINISHED）のみ利用可能です。

エンドポイント

環境	URL
本番	GET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset
サンドボックス	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset

リクエスト

ヘッダー

ヘッダー	値
Authorization	Bearer <access_token>（認証 を参照）

パスパラメータ

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

例

cURL

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

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded PDF bundle

レスポンス

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

フィールド	型	説明
fileContents	string (base64)	base64 エンコードされた証拠バンドル。
contentType	string	MIME タイプ — 通常 application/pdf。

400 Bad Request

processId パスパラメータが欠落しているか不正な形式です。以下のエラーコードを参照してください。

401 Unauthorized

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

404 Not Found

プロセスが見つからないか、証拠セットがまだ利用できません（プロセスが未完了）。

エラーコード

メモ

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

400 Bad Request

このステータスに対してドキュメント化された特定の code または message 値はありません。

401 Unauthorized

このステータスに対してドキュメント化された特定の code または message 値はありません。

404 Not Found

このステータスに対してドキュメント化された特定の code または message 値はありません。

500 Internal Server Error

コード	メッセージ	説明
99999	Internal failure! Try again later	内部エラーが発生した場合。

次のステップ

• プロセスの完全な結果については、プロセスの取得 を参照してください。
• キャプチャされたセルフィー画像については、セルフィーの取得 を参照してください。