--- title: プロセスの作成 description: 検証プロセスを作成します。ジャーニーURLとSDKトークンを返し、ユーザーをUnicoがホストするキャプチャ体験に引き渡します。 canonical: https://developer.unico.io/ja/dual-api/developers/api-reference/web-sdk/post-process locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - [API リファレンス](/ja/dual-api/developers/api-reference/) - [Web & ネイティブ](/ja/dual-api/developers/api-reference/web-sdk/) - Create Process **このページの内容# プロセスの作成 これはすべてのWeb & SDKインテグレーションのエントリーポイントです。バックエンドがこれを呼び出してプロセスを作成し、フロントエンドが返されたトークンを使用してiFrameをレンダリングするか、ユーザーをリダイレクトするか、ネイティブSDKを初期化します。 完全なインテグレーションフローについては、[Web & SDK概要](/ja/dual-api/developers/api-reference/web-sdk/)を参照してください。 ### エンドポイント​ 環境URL**本番**`POST https://api.idcloud.unico.app/client/v1/process`**サンドボックス**`POST https://api.idcloud.uat.unico.app/client/v1/process` ### リクエスト​ ヘッダー ヘッダー値`Authorization``Bearer `（[認証](/ja/dual-api/developers/api-reference/authentication)を参照）`Content-Type``application/json` ボディパラメータ フィールド型必須説明`callbackUri`stringはいジャーニー終了後にユーザーがリダイレクトされるURL。コールバックがアプリ内で処理されるネイティブSDKフローでは `/` を使用してください。`flow`stringはいフロー識別子 - 実行する機能を決定します。例: `idunicodocs`、`idunicosign`、`idchecktrust`、`idtoken`、`idsmart`。[利用可能なフロー](/ja/dual-api/capabilities/available-flows)を参照してください。`purpose`stringはいビジネス目的。受け入れ可能な値: `creditprocess`、`biometryonboarding`、`carpurchase`、`ageverification`。`person.duiType`enumいいえドキュメントタイプ。受け入れ可能な値: `DUI_TYPE_AR_PASSPORT`、`DUI_TYPE_AR_DNI`、`DUI_TYPE_AR_LNC`、`DUI_TYPE_AT_STNR`、`DUI_TYPE_BE_NN`、`DUI_TYPE_BR_CPF`、`DUI_TYPE_BR_PASSPORT`、`DUI_TYPE_BR_CNPJ`、`DUI_TYPE_CA_SIN`、`DUI_TYPE_CH_AHV`、`DUI_TYPE_CL_RUN`、`DUI_TYPE_CL_PASSPORT`、`DUI_TYPE_CL_LICENCIA_CONDUCIR`、`DUI_TYPE_CO_NIT`、`DUI_TYPE_CO_PASSPORT`、`DUI_TYPE_CO_LICENCIA_CONDUCCION`、`DUI_TYPE_CO_CC`、`DUI_TYPE_DE_IDNR`、`DUI_TYPE_DK_CPR`、`DUI_TYPE_EC_NI`、`DUI_TYPE_ES_NIE`、`DUI_TYPE_ES_DNI`、`DUI_TYPE_FI_HETU`、`DUI_TYPE_FR_SPI`、`DUI_TYPE_GB_NINO`、`DUI_TYPE_GT_CUI`、`DUI_TYPE_ID_NIK`、`DUI_TYPE_IE_PPSN`、`DUI_TYPE_IT_CF`、`DUI_TYPE_LU_MATRICULE`、`DUI_TYPE_MX_CURP`、`DUI_TYPE_MX_RFC_PERSONA_FISICA`、`DUI_TYPE_MX_LICENCIA_CONDUCIR`、`DUI_TYPE_NG_NIN`、`DUI_TYPE_NG_BVN`、`DUI_TYPE_NG_BVN_TOKEN`、`DUI_TYPE_NG_NIN_TOKEN`、`DUI_TYPE_NL_BSN`、`DUI_TYPE_NO_FNR`、`DUI_TYPE_PE_RUC`、`DUI_TYPE_PE_DNI`、`DUI_TYPE_PE_PASSPORT`、`DUI_TYPE_PL_PESEL`、`DUI_TYPE_PT_NIF`、`DUI_TYPE_SE_PNR`、`DUI_TYPE_SE_SAMORDNINGSNUMMER`、`DUI_TYPE_TR_TCKN`、`DUI_TYPE_US_SSN`、`DUI_TYPE_US_PASSPORT`、`DUI_TYPE_US_DRIVER_LICENSE`、`DUI_TYPE_US_PASSPORT_CARD`、`DUI_TYPE_US_POLYCARBONATE_PASSPORT`、`DUI_TYPE_US_ID_CARD`、`DUI_TYPE_UY_CI`、`DUI_TYPE_ZZ_EMAIL`、`DUI_TYPE_ZZ_PHONE_NUMBER`。`person.duiValue`stringいいえフォーマットなしのドキュメント番号。`person.friendlyName`stringいいえジャーニーUIに表示されるユーザーの表示名。最大50文字。`person.phone`stringいいえDDI + DDD + 番号形式の電話番号（区切りなし）。SMSまたはWhatsAppで通知を送信する場合に必須。`person.email`stringいいえメールアドレス。電子署名を含むフローに必須。`person.notifications`arrayいいえジャーニーリンクを送信するための通知チャネル。各アイテムには `notificationChannel` があります: `NOTIFICATION_CHANNEL_WHATSAPP`、`NOTIFICATION_CHANNEL_SMS`、または `NOTIFICATION_CHANNEL_EMAIL`。`bioTokenId`string (UUID)条件付き**非推奨。** 代わりに `references` を使用してください。リファレンス生体認証プロセスのID。1:1 バリデーションフロー（`idtoken`、`idtokentrust`、`idtokensign`）およびスマート再検証（`idsmart`）に必須。`references`array条件付き`bioTokenId` を置き換える1:1 バリデーションおよびスマート再検証フローのリファレンス入力。各アイテムには `referenceType`（`REFERENCE_TYPE_IMAGE_BASE64` または `REFERENCE_TYPE_PROCESS_ID`）と `referenceContent`（base64エンコード画像またはプロセスUUID）が含まれます。`useCase`string条件付きスマート再検証のシナリオ。`idsmart` に必須。例: `USE_CASE_LOGIN`、`USE_CASE_IDENTITY_REVALIDATION_7_DAYS`、`USE_CASE_FIN_TRANSACTIONS`。`clientReference`string条件付きあなたのシステムにおけるユーザーの一意の識別子。**[マルチアカウント](/ja/capabilities/multi-accounts)ケイパビリティに必須です。** 自社ベース内で一意、最大 256 文字、スペース不可。`companyBranchId`string (UUID)いいえ支店ID。サービスアカウントに複数の支店が関連付けられている場合のみ必須。`expiresIn`stringいいえ作成からのプロセス有効期間。フォーマット: `"3600s"`。省略した場合、デフォルトは7日間です。`flow_config`objectいいえフローごとの設定オーバーライド。`flow_config.biometry_capture.enabled_back_camera`booleanいいえデバイスの背面カメラを使用します。ドキュメントキャプチャまたは電子署名フローとは互換性がありません。`contextualization`objectいいえキャプチャの理由を説明するためにジャーニー中にユーザーに表示されるトランザクションコンテキスト。`contextualization.company_name`stringいいえジャーニー中に表示される会社名。最大20文字。`contextualization.currency`stringいいえユーザーに表示される通貨コード。受け入れ可能な値: `BRL`、`MXN`、`USD`。`contextualization.price`numberいいえユーザーに表示されるトランザクション金額。`contextualization.locale`objectいいえジャーニー中に表示されるローカライズされたテキスト。キー: `ptBr`、`enUs`、`esMx`。`contextualization.locale.{ptBr|enUs|esMx}.reason`stringいいえジャーニー中に表示されるキャプチャの簡単な理由。最大50文字。`contextualization.locale.{ptBr|enUs|esMx}.title`stringいいえジャーニー中に表示される顧客通知のタイトル。最大100文字。`text` と一緒に指定する必要があります。HTMLタグは除去されます。`contextualization.locale.{ptBr|enUs|esMx}.text`stringいいえジャーニー中に表示される顧客通知の本文。最大210文字。`title` と一緒に指定する必要があります。HTMLタグは除去されます。 ### 例​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "callbackUri": "https://app.client.com/callback", "flow": "idunicodocs", "purpose": "biometryonboarding", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909", "friendlyName": "Luke Skywalker", "phone": "5511912345678", "email": "luke@example.com" } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.idcloud.unico.app/client/v1/process', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ callbackUri: 'https://app.client.com/callback', flow: 'idunicodocs', purpose: 'biometryonboarding', person: { duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678909', friendlyName: 'Luke Skywalker', phone: '5511912345678', email: 'luke@example.com' } })});const { process: proc } = await res.json();// proc.userRedirectUrl, proc.token, proc.webAppToken ``` ### レスポンス​ 200 OK ``` { "process": { "id": "53060f52-f146-4c12-a234-5bb5031f6f5b", "state": "PROCESS_STATE_CREATED", "flow": "idunicosign", "purpose": "biometryonboarding", "callbackUri": "https://app.client.com/callback", "clientReference": "your-internal-id-123", "companyBranchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "userRedirectUrl": "https://cadastro.unico.app/process/53060f52-f146-4c12-a234-5bb5031f6f5b", "token": "eyJhbGciOiJSUzI1NiIs...", "webAppToken": "eyJhbGciOiJSUzI1NiIs...", "createdAt": "2023-10-09T09:15:25.417105Z", "expiresAt": "2023-10-09T16:15:25.417105Z", "capacities": [], "authenticationInfo": {}, "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909", "friendlyName": "Luke Skywalker", "phone": "5511912345678", "email": "luke@example.com", "notifications": [] }, "companyData": { "branchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "countryCode": "BR" } }} ``` フィールド型説明`process.id`string (UUID)プロセス識別子。[プロセスの取得](/ja/dual-api/developers/api-reference/web-sdk/get-process)で結果を取得するために使用します。`process.state`enum`PROCESS_STATE_CREATED` - プロセスが作成され、ジャーニーはまだ開始されていません。`PROCESS_STATE_FAILED` - プロセスの作成に失敗しました。`process.flow`string作成時に送信されたフロー識別子。`process.purpose`string作成時に送信されたビジネス目的。`process.callbackUri`string作成時に送信されたコールバックURI。`process.clientReference`string作成時に送信された内部識別子。リクエストで提供された場合のみ存在します。`process.companyBranchId`string (UUID)支店ID。リクエストで提供された場合のみ存在します。`process.userRedirectUrl`stringユーザーをリダイレクトするURL（WebリダイレクトおよびiFrameインテグレーション）。このURLを変更しないでください。`process.token`string**Web SDK iFrame**を初期化するためのJWT。`process.webAppToken`string**ネイティブSDK**（Android、iOS、Flutter）を初期化するためのJWT。`process.createdAt`string (date-time)プロセスが作成されたタイムスタンプ。`process.expiresAt`string (date-time)プロセスが期限切れとなり、完了できなくなるタイムスタンプ。`process.capacities`arrayこのプロセスに設定された機能。`process.authenticationInfo`objectプロセスの認証情報（作成時は空）。`process.person`object作成時に送信された `person` オブジェクトのエコー。`process.companyData.branchId`string (UUID)プロセスに関連付けられた支店ID。`process.companyData.countryCode`string支店に関連付けられた国コード（例: `BR`、`MX`）。 ### エラーコード​ 400 Bad Request401 Unauthorized429 Too Many Requests500 Internal Server Errorコードメッセージ説明`3`invalid flow指定されたフローが存在しない場合。`3`invalid person: friendly name exceeds 50 characters.フレンドリー名が50文字を超えている場合。`3`invalid purpose提供された目的が無効な場合。`3`invalid callbackUri: unable to parse callbackUri: parse "": empty url, invalid callbackUri: url:提供されたcallbackUriが無効な場合。`3`invalid person: email required for notification channel NOTIFICATION_CHANNEL_EMAIL, invalid email address for notification channel NOTIFICATION_CHANNEL_EMAIL提供されたメールが無効でメール通知が設定されている場合。`3`invalid person: phone number required for notification channel NOTIFICATION_CHANNEL_WHATSAPP, phone number does not contain 13 chars for notification channel NOTIFICATION_CHANNEL_WHATSAPP提供された電話番号が無効でSMSまたはWhatsApp通知が設定されている場合。`3`idnsv2/GetPublicID request error: rpc error: code = InvalidArgument desc = invalid dui value提供された識別子（duiValue）が無効な場合。`3`invalid expiresIn argument`expiresIn` の値が無効な場合。`3`invalid company_name argument in process contextualization, max length is 20`contextualization.company_name` が20文字を超えている場合。`3`title and text must be provided together in process contextsロケール内で `title` または `text` のいずれか一方のみが指定されている場合。`3`invalid title argument in process contexts, max length is 100ロケールの `title` が100文字を超えている場合。`3`invalid text argument in process contexts, max length is 210ロケールの `text` が210文字を超えている場合。`3`invalid reason argument in process contexts, max length is 50ロケールの `reason` が50文字を超えている場合。`9`XX ID Apikeys are not setAPIキーが正しく設定されていない場合。Bearerトークンが欠落、期限切れ、または無効です。[認証](/ja/dual-api/developers/api-reference/authentication)を参照してください。メッセージ説明Jwt header is an invalid JSON使用されたアクセストークンに不正な文字が含まれている場合。Jwt is expired使用されたアクセストークンが期限切れの場合。レート制限に達しました。システムがHTTP 429エラーを受信した場合、カスケード障害を防ぎ、制限の悪化を避けるためのメカニズムを実装する必要があります。**ベストプラクティス:** **クールダウン期間（バックオフ）:** システムからの後続リクエストを直ちに停止またはスロットルしてください。失敗したリクエストをタイトループで継続的にリトライしないでください。 **キューイングとスロットリング:** 再送信前にトラフィックフローを制御するために、送信リクエストをバッファまたはキューに入れてください。 **ジッターを含む指数バックオフ:** リトライ時に、試行間の待機時間を指数的に増加させ（例: 1秒、2秒、4秒、8秒）、すべてのキューされたリクエストがまったく同じミリ秒にリトライするハード効果を防ぐために小さなランダム遅延（「ジッター」）を追加してください。 警告バックオフせずにレート制限されたエンドポイントに継続的にアクセスすると、**制限期間が延長**され、システムの運用スループットに深刻な影響を与える可能性があります。リクエストを適切にスロットリングすることで、よりスムーズで回復力のあるインテグレーションが確保されます。デフォルトの制限、リクエストの増加、その他の詳細については、[レート制限](/ja/dual-api/developers/api-reference/rate-limits)を参照してください。コードメッセージ説明`99999`Internal failure! Try again later内部エラーが発生した場合。 ### 次のステップ​ ユーザーがジャーニーを完了した後、結果を取得するには[プロセスの取得](/ja/dual-api/developers/api-reference/web-sdk/get-process)を呼び出すか、[Webhook](/ja/developers/webhooks-and-events)を待ちます。 すべてのレシピの組み合わせとその可能な結果値を確認するには、[フロー](/ja/dual-api/developers/api-reference/web-sdk/flows)を参照してください。 最終更新 2026年10月8日**に