---
title: プロセスの取得
description: プロセス ID で Human Token のプロセスとその humanToken を取得します。Human Token Journey の完了後や、API Only の結果を再照会する際に使用します。
canonical: https://developer.unico.io/ja/human-token/api-reference/get-process
locale: ja
generated_by: markdown-export
---

- [/ja/](/ja/)
- APIリファレンス
- プロセスの取得

**このページの内容プロセスの取得GETHuman Token プロセスを識別子で取得します。ユーザーが Human Token Journey から戻った後や、API Only の結果を再照会する際に使用します。

### エンドポイント​

環境URL**本番**`GET https://humantoken.unico.app/client/v1/process/{processId}`
### リクエスト​

ヘッダー
ヘッダー値`x-unico-accesskey``<your_access_key>`（[認証](/ja/human-token/get-started/authentication)を参照）
パスパラメータ
パラメータ型必須説明`processId`string (UUID)はい[プロセスの作成](/ja/human-token/api-reference/post-processes)で返されたプロセス識別子。
### 例​

cURLNode.js```
curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

```
import fetch from 'node-fetch';const res = await fetch(  `https://humantoken.unico.app/client/v1/process/${processId}`,  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } });const result = await res.json();// result.data.humanToken.value
```

### レスポンス​

200 OK
レスポンスの形式は[プロセスの作成](/ja/human-token/api-reference/post-processes#responses)と同じです。`data` の構造は、プロセス作成時に使用されたフローによって異なります。
**標準フロー**（`api+humantoken`、`api+liveness+humantoken`、`humantoken`）：
```
{  "id": "6ed74799-4c2f-4023-b43f-a73cf7c847b2",  "state": "PROCESS_STATE_FINISHED",  "data": {    "humanToken": {      "value": "3f9a1c7e5b2d4086a1e3c5f7092b4d6e8a0c2e4f6183a5c7e9b1d3f5072a4c6e",      "status": "validated"    }  }}
```

**再検証フロー**（`api+liveness+humantoken+revalidation`、`humantoken+revalidation`）：
```
{  "id": "cb0472c0-6dbc-46c6-b830-2be7edc35424",  "state": "PROCESS_STATE_FINISHED",  "data": {    "humanTokenMatch": "true"  }}
```

フィールド型説明`id`string (UUID)プロセス識別子。`state`stringプロセスの状態。[`state` の値](#state-values)を参照してください。`data.​humanToken.​value`string標準フローのみ。顔の安定した不透明な識別子（最大100文字  ）。同じ人物は常に同じ値に解決されます。`data.​humanTokenMatch`string再検証フローのみ。セルフィーが参照された `humanToken` と一致する場合は `"true"`、一致しない場合は `"false"`。
state の値
値意味`PROCESS_STATE_UNSPECIFIED`状態が設定されていません。`PROCESS_STATE_CREATED`プロセスは作成済みで、新しいセッションをまだ受け付けます。`data` は `{}` です。`PROCESS_STATE_FINISHED`プロセスは完了し、新しいセッションを受け付けません。標準フローでは、Human Token が生成された場合に `data.humanToken` が含まれます。再検証フローでは、`data.humanTokenMatch` がセルフィーが参照トークンと一致したかどうかを示します。それ以外の場合 `data` は `{}` です。`PROCESS_STATE_FAILED`プロセスは失敗しました。`data` は `{}` です。`PROCESS_STATE_CANCELED`プロセスはキャンセルされました。`data` は `{}` です。`PROCESS_STATE_AWAITING_FOR_DOCUMENT`プロセスは本人確認書類を待っています。`data` は `{}` です。
警告`data.humanToken.value` を使用する前に、必ず空でないことを確認してください。
### エラーコード​

400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server Errorコードメッセージ説明`3`process id is invalidプロセス ID が無効な場合。`x-unico-accesskey` ヘッダーのアクセスキーが存在しないか、無効です。[認証](/ja/human-token/get-started/authentication)を参照してください。コードメッセージ説明`5`error getting process: rpc error: code = NotFound desc = process not foundプロセス ID が見つからなかった場合。レート制限に達しました。システムが HTTP 429 エラーを受信した場合、連鎖的な障害を防ぎ、制限の悪化を避けるためのメカニズムを実装する必要があります。
**ベストプラクティス:**

**クールダウン期間（バックオフ）:** システムからの後続のリクエストを直ちに停止または抑制してください。失敗したリクエストを短いループで継続的にリトライしないでください。
**キューイングとスロットリング:** 送信リクエストをバッファリングまたはキューに入れて、再送信前にトラフィックフローを制御してください。
**ジッター付き指数バックオフ:** リトライ時には、試行間の待機時間を指数的に増加させ（例: 1秒、2秒、4秒、8秒）、小さなランダムな遅延（「ジッター」）を追加して、キュー内のすべてのリクエストがまったく同じミリ秒にリトライするハードエフェクトを防止してください。

警告バックオフを適用せずにレート制限されたエンドポイントにリクエストを送り続けると、**制限期間が延長され**、システムの運用スループットに深刻な影響を与える可能性があります。リクエストを適切にスロットリングすることで、よりスムーズで回復力のあるインテグレーションが実現します。
デフォルトの制限、リクエストの増加、その他の詳細については、[レート制限](/ja/developers/start/rate-limits)を参照してください。コードメッセージ説明`99999`Internal failure! Try again later内部エラーが発生した場合。
### 次のステップ​

新しいセルフィーを送信するには、[プロセスの作成](/ja/human-token/api-reference/post-processes)に戻ってください。
`humanToken` が何を表すか、また生成されない場合については、[Human Token の概要](/ja/human-token/)を参照してください。
最終更新 2026年10月22日**に