--- title: 概要 description: IDCloud API のリファレンス — 2 つの公開コントラクト（Web & SDK および API）。 canonical: https://developer.unico.io/ja/dual-api/developers/api-reference/ locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - API リファレンス **このページの内容# 概要 ### コントラクトの選択​ コントラクトの選択は、**生体認証キャプチャが行われる場所**の結果であり、独立した決定ではありません。以下の表をガイドとして使用してください。 コントラクト使用する場面キャプチャフロー**[Web & SDK](/ja/dual-api/developers/api-reference/web-sdk)**キャプチャジャーニーが Unico によってホストされている場合（Web iFrame、リダイレクト、またはネイティブ SDK）Unico が制御キャプチャ**前に**プロセスを作成 → ユーザーがジャーニーを経由 → コールバックまたはポーリングで結果が返される**[API](/ja/dual-api/developers/api-reference/api)**アプリケーションがキャプチャを制御し（Unico SDK を使用するかどうかに関わらず）、呼び出しで直接画像を送信する場合クライアントが制御プロセス作成と**同時に**画像を送信 → 同期的に結果が返される ### ホストと環境​ コントラクトサンドボックスホスト本番ホストWeb & SDK`https://api.idcloud.uat.unico.app``https://api.idcloud.unico.app`API`https://api.id.uat.unico.app``https://api.id.unico.app`OAuth2 / Token`https://identityhomolog.acesso.io``https://identity.acesso.io` 詳細は[環境](/ja/dual-api/developers/api-reference/environments)を参照してください。 ### 認証​ すべての Unico コントラクトは、`urn:ietf:params:oauth:grant-type:jwt-bearer` を使用した OAuth2 で取得した **Bearer トークン（JWT）** を使用します。 詳細は[認証](/ja/dual-api/developers/api-reference/authentication)を参照してください。 ### コントラクト間のペイロードの違い​ 同じ概念的な操作（「本人確認プロセスの作成」）は、各コントラクトで異なる形式をとります。統合間で移行する際の簡単なリファレンスとして以下の表を使用してください。 プロセス作成 側面Web & SDKAPI**エンドポイント**`POST /client/v1/process``POST /processes/v1`**認証**`Authorization: Bearer ``Authorization: Bearer ` + `APIKEY`**画像**送信しない（Unico のジャーニーでキャプチャ）`imageBase64` として送信**ユーザー識別**`person.duiType` + `person.duiValue``subject.code`（CPF / CURP）**ドキュメントタイプ**CPF、CURP、SSN、NIN、DNI、NIKCPF、CURP のみ**パイプライン定義**`flow`（列挙型、30 以上の値）`APIKEY` に暗黙的（機能）**コールバック**`callbackUri`（ユーザーリダイレクト）なし（同期）**Webhook**Webhook v1（最終結果）Webhook v1（オプション）**ジャーニー URL を返す**あり（`userRedirectUrl`）なし**結果**非同期（GET ポーリングまたは Webhook）同期（レスポンスで）**SDK トークン**あり（`token`、`webAppToken`）なし 結果の取得 側面Web & SDKAPI**エンドポイント**`GET /client/v1/process/\{id\}``GET /processes/v1/\{id\}`（作成レスポンスにも含まれる）**ステータス**`state` + `result`（プレフィックス付き列挙型）`status`（1、3、5）**結果構造**`process.authenticationInfo.{capability}Result` の下にネスト。メキシコでは `authenticationInfo` の下に `idGov`。フラット：`unicoId`、`liveness`、`government`、`identityFraudsters`、`idGov`（メキシコのみ）**ドキュメント**`services[].documents[]`（OCR 付き RG/CNH）別エンドポイント（`GET /processes/v1/\{id\}/document`） ### 次のステップ​ [認証](/ja/dual-api/developers/api-reference/authentication) — OAuth2 フローと JWT 生成 [環境](/ja/dual-api/developers/api-reference/environments) — サンドボックスと本番 [Postman コレクション](/ja/dual-api/developers/api-reference/postman) — すぐに使えるコレクション [Webhook とイベント](/ja/developers/webhooks-and-events) — 非同期結果配信 [SDK とツール](/ja/developers/sdks-and-tools/overview) — Web SDK、Android、iOS、Flutter 最終更新 2026年10月8日**に