--- title: プロセスの作成 description: Human API で Human Token プロセスを作成し（セルフィーを送信する API Only、または Human Token Journey を開始）、data.humanToken で humanToken を取得します。 canonical: https://developer.unico.io/ja/human-token/api-reference/post-processes locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - APIリファレンス - プロセスの作成 **このページの内容プロセスの作成POSTバックエンドから Human Token プロセスを作成し、data.humanToken で humanToken を取得します。 Human Token は Human API の `POST /client/v1/process` エンドポイントで実行されます。API Only フロー（`api+humantoken`、`api+liveness+humantoken`、`api+liveness+humantoken+revalidation`）では、プロセスの作成と完了が1回の呼び出しで行われます。レスポンスには、すでに `data.humanToken` に結果が含まれています。Human Token Journey フロー（`humantoken` および `humantoken+revalidation`）では、レスポンスにプロセスの `id`、`token`、ジャーニーの `link` が含まれ、ユーザーがジャーニーを完了した後に結果が利用可能になります。`+revalidation` フローでは、再検証のために以前に取得した `humanToken` を含む `references` 配列が必要です。 ### フロー​ Human Token は2つの統合モデルで実行されます。 **API Only** — バックエンドがセルフィーを `imageBase64` で送信します。 **Human Token Journey** — ユーザーが Web 上で Unico のジャーニーを進め、完了後にあなたの `callbackUri` に戻ります。 FlowCapabilitiesPossible resultIntegration componentsrequiredExample`api+humantoken`[Human Token](/ja/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken`Liveness[Human Token](/ja/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken+revalidation`Liveness[Human Token](/ja/human-token/)RevalidationPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`humantoken`Liveness[Human Token](/ja/human-token/)PROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example`humantoken+revalidation`Liveness[Human Token](/ja/human-token/)RevalidationPROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example ### エンドポイント​ 環境URL**本番**`POST https://humantoken.unico.app/client/v1/process` ### リクエスト​ ヘッダー ヘッダー値`x-unico-accesskey```（[認証](/ja/human-token/get-started/authentication)を参照）`Content-Type``application/json` ボディパラメータ フィールド型必須説明`flow`stringはいHuman Token フロー: `api+humantoken`、`api+liveness+humantoken`、`api+liveness+humantoken+revalidation`（API Only）または `humantoken`、`humantoken+revalidation`（Human Token Journey）。[フロー](#flows)を参照してください。`imageBase64`stringAPI Onlyフロントエンドでキャプチャし、直接送信するセルフィー（base64）。PNG、JPEG または WebP、最大 800 KB。[キャプチャスタンダード](/ja/human-token/additional-resources/capture-standard)に従ってください。`callbackUri`stringHuman Token Journeyジャーニー終了後にユーザーがリダイレクトされる URL。`companyBranchId`stringいいえブランチ識別子。指定された場合、プロセスは指定されたブランチの構成を使用します。`references`array再検証フロー参照オブジェクトの配列。`+revalidation` フローで必須です。各オブジェクトには `referenceType`（`REFERENCE_TYPE_HUMAN_TOKEN`）と `referenceContent`（以前に取得した `humanToken` の値）が含まれます。 ### レスポンス​ 200 OK フィールド型説明`id`string (UUID)プロセス識別子。[プロセスの取得](/ja/human-token/api-reference/get-process)でプロセスを再取得する際に使用します。`state`stringプロセスの状態。[結果の解釈](#interpreting-the-result)を参照してください。API Only フローのみ。`token`string作成されたプロセスのトークン。Journey SDKエクスペリエンスを開くために使用できます。Human Token Journeyフロー（`humantoken`、`humantoken+revalidation`）のみ。`link`stringHuman Token Journey の URL です。ユーザーをこの URL に送ります。Human Token Journey フロー（`humantoken`、`humantoken+revalidation`）のみ。`data.​humanToken.​value`string顔の安定した不透明な識別子（最大100文字）。同じ人物は常に同じ値に解決されます。API Only フローのみ（再検証以外）。`data.​humanTokenMatch`stringセルフィーが参照された `humanToken` と一致する場合は `"true"`、一致しない場合は `"false"`。`+revalidation` API Only フローのみ。 結果の解釈 `state`意味対応`PROCESS_STATE_FINISHED``data.humanToken.value` あり：Human Token を持つ実在の人物。自社の記録で `value` を検索してください。存在する場合は再訪ユーザーまたは重複の可能性があり、存在しない場合は新しい人物です。`PROCESS_STATE_FINISHED``data.humanToken` なし、または `value` が空：判定不能。判定不能として扱ってください。空の `value` は絶対に保存・照合しないでください。ビジネスルールに従って、プロセスを再試行するか拒否してください。`PROCESS_STATE_FAILED`本人確認プロセスが失敗しました。ビジネスルールに従い、プロセスを再試行するか拒否してください。`PROCESS_STATE_CREATED`プロセスが作成されました。待機してください。後で[プロセスの取得](/ja/human-token/api-reference/get-process)で結果を取得してください。`PROCESS_STATE_CANCELED`プロセスがキャンセルされました。ユーザーの確認がまだ必要な場合は、新しいプロセスを作成してください。 警告`data.humanToken.value` を使用する前に、必ず空でないことを確認してください。 ### エラーコード​ メモ`x-unico-accesskey` ヘッダーのアクセスキーが存在しない、または無効な場合に返される HTTP ステータスは現在確認中です。[認証](/ja/human-token/get-started/authentication)を参照してください。 400 Bad Request403 Forbidden429 Too Many Requests500 Internal Server Errorコードメッセージ説明`3`invalid flow指定されたフローが存在しない場合。`3`INVALID_IMAGE画像が有効な base64 でない、またはインジェクション攻撃の疑いがある場合。`3`IMAGE_TOO_LARGE画像が最大サイズ 800 KB を超えている場合。`3`UNSUPPORTED_IMAGE_FORMAT画像フォーマットが PNG、JPEG、または WebP でない場合。`3`MISSING_IMAGEこのフローに画像が必須であるにもかかわらず、送信されなかった場合。`3`INVALID_REQUESTリクエストボディが null、または解釈できない場合。`9`monthly process limit of reached for this tenant月間利用上限に達した場合。`9`PROCESS_FAILEDプロセスの作成中に終了状態の失敗に達した場合。コードメッセージ説明`7`PERMISSION_DENIED認証情報は有効だが、この操作の権限がない場合。レート制限に達しました。システムが HTTP 429 エラーを受信した場合、連鎖的な障害を防ぎ、制限の悪化を避けるためのメカニズムを実装する必要があります。 **ベストプラクティス:** **クールダウン期間（バックオフ）:** システムからの後続のリクエストを直ちに停止または抑制してください。失敗したリクエストを短いループで継続的にリトライしないでください。 **キューイングとスロットリング:** 送信リクエストをバッファリングまたはキューに入れて、再送信前にトラフィックフローを制御してください。 **ジッター付き指数バックオフ:** リトライ時には、試行間の待機時間を指数的に増加させ（例: 1秒、2秒、4秒、8秒）、小さなランダムな遅延（「ジッター」）を追加して、キュー内のすべてのリクエストがまったく同じミリ秒にリトライするハードエフェクトを防止してください。 警告バックオフを適用せずにレート制限されたエンドポイントにリクエストを送り続けると、**制限期間が延長され**、システムの運用スループットに深刻な影響を与える可能性があります。リクエストを適切にスロットリングすることで、よりスムーズで回復力のあるインテグレーションが実現します。 デフォルトの制限、リクエストの増加、その他の詳細については、[レート制限](/ja/developers/start/rate-limits)を参照してください。コードメッセージ説明`13`Internal failure! Try again later内部エラーが発生した場合。 このエンドポイントのコードの完全な一覧については、Human API の[プロセスの作成](/ja/developers/api-reference/post-processes#error-codes)リファレンスを参照してください。 ### 次のステップ​ 後続の Human Token 呼び出しで同一人物を認識するために、`humanToken` の値をユーザーレコードと一緒に保存してください。 監査やサポートのためにプロセスを再取得するには、[プロセスの取得](/ja/human-token/api-reference/get-process)を使用してください。 最終更新 2026年10月22日**に