証跡セットの取得
生体認証キャプチャ中に生成された証跡バンドルを返します。これは、ライブネス検出が管理された条件下で実行されたことを証明するために使用される、キャプチャ画像、メタデータ、キャプチャ成果物を含むパッケージです。
完了したプロセス（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はBase64エンコードされたPDFバンドルです
レスポンス
200 OK
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "application/pdf"
}
| フィールド | 型 | 説明 |
|---|---|---|
fileContents | string (base64) | Base64エンコードされた証跡バンドル。 |
contentType | string | MIMEタイプ — 通常は application/pdf。 |
エラーコード
メモ
このエンドポイントでは、特定の code や message の値は返されません。
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
processId パスパラメータが欠落しているか、不正な形式です。
Bearerトークンが欠落している、期限切れ、または無効です。認証を参照してください。
プロセスが見つからないか、証跡セットがまだ利用できません（プロセスが完了していません）。
| コード | メッセージ | 説明 |
|---|---|---|
99999 | Internal failure! Try again later | 内部エラーが発生した場合。 |