--- title: プロセスドキュメントの設定 description: ドキュメントなしで作成されたプロセスに身分証明書を設定します。ドキュメントを必要とする機能をトリガーします。 canonical: https://developer.unico.io/ja/dual-api/developers/api-reference/web-sdk/post-process-document locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - [API リファレンス](/ja/dual-api/developers/api-reference/) - [Web & ネイティブ](/ja/dual-api/developers/api-reference/web-sdk/) - Set Process Document **このページの内容# プロセスドキュメントの設定 ドキュメントなしで作成されたプロセスに身分証明書（CPF、CURP、SSNまたはその他の `duiType`）を設定します。設定後、ドキュメントは変更不可になります。 カスタムフローがドキュメントなしでの作成を許可するプロセス、つまり `AWAITING_FOR_DOCUMENT` 状態のプロセスでのみ使用可能です。 ### エンドポイント​ 環境URL**本番**`POST https://api.idcloud.unico.app/client/v1/process/{processId}/document`**サンドボックス**`POST https://api.idcloud.uat.unico.app/client/v1/process/{processId}/document` ### リクエスト​ ヘッダー ヘッダー値`Authorization``Bearer `（[認証](/ja/dual-api/developers/api-reference/authentication)を参照）`Content-Type``application/json` パスパラメータ フィールド型必須説明`processId`stringはい作成時に `process.id` で返されたプロセスID。 ボディパラメータ フィールド型必須説明`duiType`enumはいドキュメントタイプ。値: `DUI_TYPE_BR_CPF`、`DUI_TYPE_MX_CURP`、`DUI_TYPE_US_SSN`。このエンドポイントは[プロセスの作成](/ja/dual-api/developers/api-reference/web-sdk/post-process)で受け入れられるドキュメントタイプのサブセットをサポートしています。オプションのドキュメント作成を許可するカスタムフローは、現在このより狭いリストに対して検証されます。`duiValue`stringはいフォーマットなしのドキュメント番号。最大320文字（エンコードまたは複合識別子に対応。CPFやCURPなどの標準的なドキュメント番号は大幅に短くなります）。 ### 例​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process/abc-123/document \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678901" }' ``` ``` import fetch from 'node-fetch';const res = await fetch( 'https://api.idcloud.unico.app/client/v1/process/abc-123/document', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678901', }), });const { process: proc } = await res.json();// proc.id, proc.person.duiType, proc.person.duiValue ``` ### レスポンス​ 200 OK ``` { "process": { "id": "abc-123", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678901" } }} ``` フィールド型説明`process.id`stringプロセス識別子。`process.person.duiType`stringプロセスに設定されたドキュメントタイプ。`process.person.duiValue`stringプロセスに設定されたドキュメント値。 ### エラーコード​ 400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server Errorコードメッセージ説明`3``process id is invalid`プロセスIDが無効な場合。`3``dui_type is required`ドキュメントタイプが提供されていない場合。`3``dui_value is required`ドキュメント番号が提供されていない場合。`3``dui_value exceeds maximum length`ドキュメント番号が最大文字数制限を超えている場合。`9``process is not awaiting for document`指定されたプロセスがドキュメント送信を受け付けない場合。`9``process expired`指定されたプロセスが期限切れの場合。`9``document already set, cannot be modified`プロセスに既にリンクされたドキュメントがある場合。`9``process already finished`プロセスが既に完了している場合。`9``flow does not allow optional document`プロセスで実行されるフローにドキュメントが必須の場合。Bearerトークンが欠落、期限切れ、または無効です。[認証](/ja/dual-api/developers/api-reference/authentication)を参照してください。メッセージ説明Jwt header is an invalid JSON使用されたアクセストークンに不正な文字が含まれている場合。Jwt is expired使用されたアクセストークンが期限切れの場合。コードメッセージ説明`5``error getting process: rpc error: code = NotFound desc = process not found`プロセスIDが見つからなかった場合。レート制限に達しました。システムが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)を待ちます。 最終更新 2026年10月8日**に