--- title: 再処理と生体認証ベースのインポート description: Unicoプラットフォームでの生体認証レコードの再処理または生体認証ベースのインポートに関するガイド。 canonical: https://developer.unico.io/ja/dual-api/resources/reprocessing locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - リソース - 再処理と生体認証ベースのインポート **このページの内容# 再処理と生体認証ベースのインポート このガイドでは、Unicoプラットフォームでの**再処理**または**生体認証ベースのインポート**の実施方法について説明します。プラットフォームのベストプラクティスに従った効果的で安全な統合のための技術的・運用上の要件を詳述します。 ### スコープ​ この資料では、2種類のプロセスを対象としています: **再処理**: クライアントおよびUnicoのベースを既に通過したユーザーの生体認証レコードを、再評価またはシステム間の移行のために再処理します。 **生体認証ベースのインポート**: 本人確認およびリスク分類を目的とした、セルフィーを含むベースの初期アップロードまたは更新。 **書類ベースのインポート**: FacematchまたはCPF Match認証を目的として、セルフィーとともに書類ベースをアップロードします（ブラジル限定）。 ### 前提条件​ クライアントは、Unicoとの**有効な契約またはNDAに署名済み**であり、統合フェーズにある必要があります（ガバナンスチームによる承認がある場合は例外）。 プロジェクトは正式な**TPS（1秒あたりのトランザクション数）合意**に従います。以下の[TPS合意](#tps-agreement)を参照してください。 本番認証情報を取得する前に、データ品質、ペイロードの準拠性、安定したパフォーマンスを確保するために**統合ホモロゲーションの完了が必須**です。 再処理またはインポート用に**専用のサービスアカウント**を作成する必要があります（例:「Reprocessing」または「Legacy_Import」）。 再処理/インポート専用の**専用APIキー**が作成されます。 **（オプション）** 再処理/インポート用に専用の子会社を作成できます。このパラメータはペイロード内で`subsidiaryId`として識別されます。以下の[ペイロードパラメータ](#payload-parameters)を参照してください。 APIキーとサービスアカウントは、合意された期間の終了後または処理完了後に**無効化されます**。 ### 利用可能なケイパビリティ​ ケイパビリティ説明**本人確認**送信されたセルフィーが識別子の実際の所有者のものであるかを確認します。**不正リスク分類**その顔に関連する不正行為の履歴を確認します。**Facematch**書類の写真が送信されたセルフィーと一致するかを確認します。**CPF Match** Brazil only提供されたCPFが書類に印刷されたCPF番号と一致するかを確認します。注: すべてのRGにCPFが印刷されているわけではありません。 ### セルフィーの要件​ **base64**形式で送信する必要があります。 画像は**ICAO規格**に準拠する必要があります（明るい背景、顔が中央に位置、識別を妨げるアクセサリーなし、適切な照明）。 推奨サイズ: **1080x1920**（縦向き）または**1920x1080**（横向き）。 最大サイズ: **800 KB**（必要に応じてJPEG 92で圧縮してください）。 向き: **縦向き**。 ### 書類の要件​ **対応している書類の種類**: [ドキュメントキャプチャと再利用 — 対応書類](/ja/capabilities/document-reuse-and-capture#supported-documents)を参照してください。 画像には書類の**表面と裏面**の両方が含まれている必要があり、切り取りなしで完全に表示されている必要があります。 書類は**読み取り可能**である必要があります — 明瞭で、十分な照明があり、遮蔽物がないこと。 ### TPS合意​ このプロジェクトの合意された最大TPSは**10 TPS**です。 リクエストを大量のバーストで送信するのではなく、時間をかけて均等に分散してください。 Unicoチームからの正式な承認なしにこの制限を**超えてはなりません**。 制限を超えたリクエストは自動的にドロップまたはブロックされる場合があります。 一時的な増加が必要な場合は、**事前の正式な合意**が必要です。 ### 統合​ #### エンドポイント​ 環境ベースURLアクセス備考ステージング`https://api.id.uat.unico.app`オープンテスト必須本番`https://api.id.unico.app`承認されたホモロゲーション後のみ厳格なTPS管理が必要 #### 必須ヘッダー​ ``` Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json ``` #### ペイロードパラメータ​ ``` { "subject": { "duiType": 1, "code": "11032395702", "name": "User Name", "email": "username@gmail.io", "phone": "21998571922", "birthDate": "30/07/1989", "gender": "M" }, "useCase": "Reprocessamento/Importação", "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819", "imageBase64": "/9j/4AAQSkZJR...", "document": { "purpose": "Reprocessamento", "documentId": "doc-001", "files": [ { "data": "doc_base64_frente", "faceDocumentMatch": true }, { "data": "doc_base64_verso" } ] }} ``` フィールド型必須説明`subject`objectはいユーザー識別データ。`subject.duiType`integerはいドキュメントタイプ識別子。以下の[`duiType`の値](#duitype-values)を参照してください。`subject.code`stringはいCPFまたはその他のユーザー識別子。`subject.name`stringはいユーザーのフルネーム。`subject.email`stringいいえユーザーのメールアドレス。`subject.phone`stringいいえユーザーの電話番号。`subject.birthDate`stringいいえユーザーの生年月日（`DD/MM/YYYY`）。`subject.gender`stringいいえユーザーの性別（`M`または`F`）。`useCase`stringはいユースケース名（「Reprocessamento」または「Importação de base」）。`subsidiaryId`stringいいえ子会社UUID（Unicoから提供）。`imageBase64`base64はいbase64に変換されたユーザーのセルフィー画像。`document`objectいいえプロセスに関連するドキュメントデータ。`document.purpose`stringいいえドキュメントの目的（例: `"Reprocessamento"`）。`document.documentId`stringいいえドキュメント識別子。`document.files`arrayいいえドキュメント画像ファイルのリスト。`document.files[].data`base64いいえbase64に変換されたドキュメント画像。`document.files[].faceDocumentMatch`booleanいいえドキュメント内の顔が送信されたセルフィーと一致するかどうかを示します。 **`duiType` の値**国コード説明AR6アルゼンチン パスポートAR7アルゼンチン DNIAR49アルゼンチン 運転免許証（Licencia Nacional de Conducir）AT34オーストリア 納税者番号（STNR）BE36ベルギー 国民番号（NN）BR1ブラジル CPFBR5ブラジル パスポートBR14ブラジル CNPJCA28カナダ SINCH33スイス AHV/AVS番号CL9チリ RUNCL52チリ パスポートCL57チリ 運転免許証（Licencia de Conducir）CO26コロンビア NITCO53コロンビア パスポートCO55コロンビア 運転免許証（Licencia de Conducción）CO56コロンビア 市民証（Cédula de Ciudadanía）DE41ドイツ 税務識別番号（IdNr）DK29デンマーク CPREC10エクアドル NIES50スペイン 外国人識別番号（NIE）ES51スペイン 国民身分証明書（DNI）FI35フィンランド 個人識別番号（HETU）FR46フランス 税務参照番号（SPI）GB30英国 国民保険番号（NINO）GT12グアテマラ CUIID16インドネシア NIKIE47アイルランド 個人公共サービス番号（PPSN）IT37イタリア 税務番号（CF）LU48ルクセンブルク 国民識別番号（Matricule）MX2メキシコ CURPMX25メキシコ RFC（個人）MX58メキシコ 運転免許証（Licencia de Conducir）NG8ナイジェリア NINNG20ナイジェリア 銀行認証番号（BVN）NG43ナイジェリア BVNトークン（ハッシュ化）NG44ナイジェリア NINトークン（ハッシュ化）NL42オランダ 市民サービス番号（BSN）NO39ノルウェー 国民識別番号（Fødselsnummer）PE27ペルー RUCPE40ペルー DNIPE54ペルー パスポートPL31ポーランド PESELPT45ポルトガル 納税者番号（NIF）SE32スウェーデン 個人番号（PNR）SE38スウェーデン 調整番号（Samordningsnummer）TR24トルコ 国民識別番号（TCKN）US4アメリカ合衆国 SSNUS11アメリカ合衆国 パスポートUS18アメリカ合衆国 運転免許証US21アメリカ合衆国 パスポートカードUS22アメリカ合衆国 ポリカーボネートパスポートUS23アメリカ合衆国 IDカードUY13ウルグアイ CIZZ15メールアドレスZZ17電話番号—0未指定—3Unico 内部識別子 #### 重要な注意事項​ セルフィーは適切な品質と照明で**ICAO規格に準拠**している必要があります。 セルフィーは**base64形式**である必要があります。 TPS管理なしの大量送信は避けてください。レート制限がトリガーされる可能性があります（以下の[エラーハンドリング](#error-handling)を参照）。 常にステージング環境でデータと統合を先にテストしてください。 #### レスポンス​ **成功 — 200 OK** 書類なし書類あり（Facematch）``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "inconclusive" }, "identityFraudsters": { "result": "inconclusive" }} ``` フィールド型説明`id`stringプロセス識別子。将来のクエリや、後で1:1 バリデーションを実装する場合に備えて保存してください。`status`integerトランザクションステータス。`unicoId.result`string本人確認ケイパビリティのレスポンス。`identityFraudsters.result`string不正リスク分類ケイパビリティのレスポンス。``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "score": 0, "status": 3, "unicoId": { "result": "yes" }, "faceDocumentMatch": { "faceMatch": true }, "identityFraudsters": { "result": "yes" }} ``` フィールド型説明`id`stringプロセス識別子。将来のクエリや、後で1:1 バリデーションを実装する場合に備えて保存してください。`status`integerトランザクションステータス。`score`numberFacematchスコア。`unicoId.result`string本人確認ケイパビリティのレスポンス。`faceDocumentMatch.faceMatch`boolean書類の写真が送信されたセルフィーと一致するかどうか。`identityFraudsters.result`string不正リスク分類ケイパビリティのレスポンス。 **画像処理エラー** ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 5} ``` **一般的なエラー** `4xx`範囲のコードは、提供されたデータのバリデーションエラーを示します。`5xx`範囲のコードは、サーバー側の障害を示します。 HTTPコードエラータイプ原因の可能性推奨アクション`400`Bad Request無効なペイロード構造と内容を検証してください。`401`Unauthorized期限切れまたは無効なトークントークンを再生成してください。`403`Forbidden不正なAPIキーまたは権限不足認証情報を確認してください。`429`Too Many Requestsリクエストレート超過待機してTPS制限を遵守してください。`500+`Internal Server Error内部障害数秒後にリトライしてください。持続する場合はチケットを起票してください。 ### エラーハンドリング​ **レート制限（HTTP 429）**は慎重に監視する必要があります。リクエストの過負荷はパイプラインをブロックする可能性があります。 Unicoと合意したTPSを常に遵守してください（[TPS合意](#tps-agreement)を参照）。 持続的な障害（5xx）の場合は、リトライ/バックオフ制御で再処理してください。 最終更新 2026年10月8日**に