--- title: プロセスの取得 description: 既存のAPIコントラクトのプロセスを識別子で取得します。結果はプロセス作成時に同期的に返されるため、再照会に使用します。 canonical: https://developer.unico.io/ja/dual-api/developers/api-reference/api/get-process locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - [API リファレンス](/ja/dual-api/developers/api-reference/) - [API](/ja/dual-api/developers/api-reference/api/) - プロセスの取得 **このページの内容プロセスの取得GET既存のプロセスを識別子で取得します。APIコントラクトの仕様上、結果はプロセス作成時にすでに同期的に返されているため、このエンドポイントは再照会・監査・サポート対応に使用します。 警告プロセスを取得する前に、Webhookの設定とフォールバック戦略を確認してください — [こちらをクリック](/ja/developers/webhooks-and-events/setup)。 ### エンドポイント​ 環境URL**本番**`GET https://api.id.unico.app/processes/v1/{processId}`**サンドボックス**`GET https://api.id.uat.unico.app/processes/v1/{processId}` ### リクエスト​ ヘッダー ヘッダー値`Authorization``Bearer ``APIKEY`発行済みのAPIキー。 パスパラメータ パラメータ型必須説明`processId`string (UUID)はい[プロセスの作成](/ja/dual-api/developers/api-reference/api/post-processes)で返されるプロセス識別子。 ### 例​ cURLNode.js``` curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \ -H "Authorization: Bearer $TOKEN" \ -H "APIKEY: $API_KEY" ``` ``` import fetch from 'node-fetch';const res = await fetch( `https://api.id.unico.app/processes/v1/${processId}`, { headers: { Authorization: `Bearer ${accessToken}`, APIKEY: apiKey } });const result = await res.json(); ``` ### レスポンス​ 200 OK このコントラクトは単一で、`idCloud.result` フィールドが使用されたケイパビリティの統合された判定結果を保持します。 Unicoは、実行されたケイパビリティの結果を単一の `idCloud.result` に統合します。個々の結果をオーケストレーションする必要はなく、フローの次のステップをすぐに判断できます。 ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "idCloud": { "result": "approved" }} ``` フィールド型説明`id`string (UUID)プロセス識別子。`status`integer`1`（処理中）、`2`（不一致）、`3`（正常終了）、`4`（キャンセル）、`5`（エラー）。 可能な結果の値 idCloud.result意味推奨アクションapproved実在の人物であり、本人確認済み。フローを継続します。denied本人確認が完了しなかった、ライブネスチェックに失敗した、または重大なリスクが検出された。フローを終了するか、代替フローにリダイレクトします。critical-risk重大なリスクレベルが検出された。フローを終了するか、手動レビューに振り分けます。high-risk高いリスクレベルが検出された。手動レビューまたは代替フローに振り分けます。retry評価に十分なキャプチャまたはスコアが得られなかった。ユーザーに新しいキャプチャを依頼します。inconclusive判定に十分な証拠がない。手動レビューまたは代替フローに振り分けます。 返される値は、APIKeyに設定されたレシピによって異なります。各レシピが返す結果値については、[フロー](/ja/dual-api/developers/api-reference/api/flows)を参照してください。 ブラジルのクライアントはケイパビリティ単位のレスポンスを受け取る場合があります全体のレスポンス構造は変わらず、単一の結果がデフォルトです。ブラジルの統合はケイパビリティごとに開かれた結果を受け取る場合があります。APIKeyで有効化された各ケイパビリティがレスポンスに独自のブロックを追加し、無効なケイパビリティのフィールドは省略されます。``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "yes" }, "riskLevel": { "result": "inconclusive" }, "idFace": { "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890", "result": "FOUND" }, "identityFraudsters": { "result": "inconclusive" }, "government": { "serpro": 87 }, "liveness": 1, "idAge": { "result": "yes" }, "cardholderVerification": { "result": "approved" }} ``` フィールド型説明`unicoId.result`string`yes`、`no`、`inconclusive` — [本人確認](/ja/capabilities/identity-verification)を参照してください。`riskLevel.result`string`not_approved`、`critical_risk`、`high_risk`、`inconclusive` — [不正リスク分類](/ja/capabilities/fraud-risk-classification)を参照してください。`idFace.result`string`FOUND` — 顔識別子を参照してください。`idFace.personId`string顔に対する安定した不透明な識別子。`idFace.result = FOUND` とともに返されます。画像内で顔を識別できない場合、プロセスは `idFace` ブロックの代わりにエラー `20532` を返します。`identityFraudsters.result`string**非推奨。** 代わりに `riskLevel` を使用してください。既存の統合を持つクライアントは、プロジェクトチームと移行を調整しながら引き続き使用できます。`government.serpro`integerSerpro類似度スコア（0〜100、-1、-2）。ブラジルのみで利用可能。[Serpro類似度返却](/ja/capabilities/serpro-similarity-return)を参照してください。`liveness`integer`1`（合格）、`2`（不合格） — [ライブネス](/ja/capabilities/liveness)を参照してください。`idAge.result`string`yes`、`no`、`inconclusive` — [年齢確認](/ja/capabilities/age-verification)を参照してください。ブラジルのみで利用可能。`score`integer確率的リスクスコア。`unicoId.result = inconclusive` かつリスクスコアのオーケストレーションが有効な場合に存在します。正の値は本人である確率が高いことを示し、負の値はリスクが高いことを示します。ブラジルのみで利用可能。`cardholderVerification.result`string`approved`、`unsure` — [Cardholder Verification](/ja/capabilities/cardholder-verification)を参照してください。`status` が `3`（完了）になるまでは存在しません。ブラジルのみで利用可能。 メキシコのクライアントはRENAPO検証ブロックを受け取る場合がありますレスポンスの構造は同じままで、idGov ブロックが追加されます。RENAPO検証が有効なメキシコの統合は、ユーザーのCURPについてRENAPOが保有するレコードを含む追加の idGov ブロックを受け取ります。これは本人確認の結果とは別個の回答です。``` { "id": "11111111-2222-3333-4444-555555555555", "status": 3, "idCloud": { "result": "approved" }, "idGov": { "government_valid": true, "curp": "PUEA880304MDFRJN04", "government_name": "ANA PRUEBA EJEMPLO", "date_of_birth": "1988-03-04", "age": 38, "gender": "F", "deceased": false, "is_mexican": true, "citizenship": "MEXICO", "state_of_birth": "Ciudad de México", "state_iso": "MX-CMX", "issuing_entity_code": "DF", "municipality_registration": "" }} ``` フィールド型説明`idGov`objectCURPに対するRENAPOのレコード。ケイパビリティが有効でない場合は存在しません。RENAPOが応答しなかった場合は `{}`。メキシコのみで利用可能。[RENAPO検証](/ja/capabilities/renapo-verification)を参照してください。 ### このエンドポイントの使用タイミング​ APIコントラクトは結果を同期的に返すため、ほとんどの統合ではこのエンドポイントは不要です。次の場合に使用します。 `processId` のみを保存しており、後で完全な結果を取得する必要がある場合（監査、サポート対応）。 元のレスポンスが通信中に失われた可能性がある場合（プラットフォームが処理を完了した後のネットワークエラー）。 過去のプロセスを確認するバックオフィスツールを構築している場合。 ### エラーコード​ 400 Bad Request404 Not Found403 Forbidden410 Gone429 Too Many Requests500 Internal Server Errorコードメッセージ説明`20023`O parâmetro processId não foi informado.processId パラメータが指定されていません。`20002`O parâmetro APIKey não foi informado.リクエストヘッダーにAPIKEYパラメータがありません。`20001`O parâmetro authtoken não foi informado.リクエストヘッダーに統合トークンパラメータがありません。コードメッセージ説明`50001`O processo informado não foi encontrado.指定されたプロセスがデータベースに存在しません。コードメッセージ説明`30017`User does not have permission to perform this action.JWTが不正であるか、この操作を実行する権限がないユーザーです。`10502`O token informado está expirado.使用されたアクセストークンの有効期限が切れている場合。`10501`O token informado é inválido.認証トークンが無効です。`10201`O AppKey informado é inválido.APIKEYパラメータが入力されていないか、存在しません。プロセスは存在しますが、エラーで終了しています。`id` と `status: 5` のみを返します。レート制限に達しました。システムが HTTP 429 エラーを受信した場合、連鎖的な障害を防ぎ、制限の悪化を避けるためのメカニズムを実装する必要があります。 **ベストプラクティス:** **クールダウン期間（バックオフ）:** システムからの後続のリクエストを直ちに停止または抑制してください。失敗したリクエストを短いループで継続的にリトライしないでください。 **キューイングとスロットリング:** 送信リクエストをバッファリングまたはキューに入れて、再送信前にトラフィックフローを制御してください。 **ジッター付き指数バックオフ:** リトライ時には、試行間の待機時間を指数的に増加させ（例: 1秒、2秒、4秒、8秒）、小さなランダムな遅延（「ジッター」）を追加して、キュー内のすべてのリクエストがまったく同じミリ秒にリトライするハードエフェクトを防止してください。 警告バックオフを適用せずにレート制限されたエンドポイントにリクエストを送り続けると、**制限期間が延長され**、システムの運用スループットに深刻な影響を与える可能性があります。リクエストを適切にスロットリングすることで、よりスムーズで回復力のあるインテグレーションが実現します。 デフォルトの制限、リクエストの増加、その他の詳細については、[レート制限](/ja/dual-api/developers/api-reference/rate-limits)を参照してください。コードメッセージ説明`99999`Internal failure! Try again later内部エラーが発生した場合。 ### フロー​ レシピとは、プロジェクトのAPIKeyに設定されたケイパビリティ（ライブネス、本人確認、リスクシグナル、ドキュメントなど）の組み合わせです。各プロセスでUnicoが何を実行し、結果がどのように単一の `result` に統合されるかを定義します — お客様側でオーケストレーションを行う必要はありません。 Unicoは、名前とバージョンが付けられた事前定義済みレシピのカタログを管理しています（例: `byunico-idlive-idunico-oneresponse-std`）。Score、Serpro、年齢確認を含むものなど、一部はブラジル専用です。 プロセスはどのケイパビリティを実行しますか?ケイパビリティの組み合わせ（プロジェクトのフロー）は、APIKeyの設定で定義されます。事前定義済みのレシピを確認するか、Unicoのプロジェクト担当者にカスタマイズを相談してください。最終更新 2026年10月8日**に