証拠セットの取得
生体キャプチャ中に生成された証拠バンドルを返します — キャプチャされた画像、メタデータ、および制御された条件下で活性検知が実施されたことを証明するために使用されるキャプチャアーティファクトを含むパッケージです。
完了済みプロセス（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
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN"
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。 |
エラーコード
メモ
この API はこのエンドポイントに対する特定の code または message 値を公開していません。
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error