データ抽出
テキストの塊ではなく、構造化されたフィールドを返すOCR本人確認書類スキャンAPI。
ShieldIDは、政府発行の写真付き身分証を、氏名、生年月日、書類番号、有効期限、住所などの構造化されたフィールド単位のデータに変換します。各フィールドには、その情報源と個別の判定が付いています。同じセッションで、書類データ抽出APIと書類検証APIの両方としてご利用いただけます。
返される内容
書類に実際に記載されている範囲の、構造化フィールド。
すべての書類にすべてのフィールドが記載されているわけではありません。ShieldIDは書類にある情報を返し、ない情報にはその旨を示します。
- 氏名
- 印字されたとおりの内容と、書類にバーコードまたはMRZがある場合はそこにエンコードされた内容。
- 生年月日
- 印字面から読み取り、バーコードとMRZでクロスチェックします。
- 書類番号
- 免許証番号またはパスポート番号を、発行者の形式が許す範囲で内部整合性の観点から確認します。
- 有効期限
- 印字面とバーコードまたはMRZから読み取ります。
- 住所
- 印字面と、存在する場合はバーコードから読み取ります。別途アップロードされた住所確認書類と比較できます。
- 性別
- 書類に印字またはエンコードされている場合に読み取ります。
- 発行管轄
- 書類に認識可能なバーコード発行元コードがある場合は、そのコードから特定されます(取得可能な場合)。
3つの情報源を、1つの比較で
バーコード、MRZ、券面の印字を、意図をもって読み取り、うっかり混ざり合うことはありません。
すべての項目には、取得元の情報源が紐付けられます。2つの情報源が一致しない場合、2つの数値を平均するのではなく、結果にフラグとして示されます。
PDF417バーコード
北米の運転免許証またはIDカードの裏面は、構造化されたAAMVAフィールドにデコードされます。書類にバーコードがある場合は、表面の印字内容よりもバーコードのフィールドが優先されます。
パスポートのMRZ
機械読取領域(MRZ)を検出して読み取り、領域に組み込まれたICAOのチェックディジット計算式で検証します。最低限の有効性スコアを設け、そのスコアに照らして、MRZから読み取った項目を信頼するかどうかを判断します。自身のチェックサムに合格しない領域が、より正確な情報源を上書きすることはありません。
券面の構造化読み取りと全ページOCR
印字面は、書類固有のレイアウトが認識された場合はそのレイアウトを使って読み取られ、認識されない場合は全ページOCRに切り替わるため、見慣れない書類でも読み取り可能なフィールドが得られます。
不一致はフラグで示し、平均化はしません
券面、バーコード、MRZの間で氏名や生年月日が一致しない場合は、結果に不一致として報告されます。処理の途中で、黙って一方を採用して不一致を隠すことはありません。
MRZのチェックサム検証
機械読取領域は、信頼する前に自身の計算の整合性を確認する必要があります。
パスポートのICAO機械読取領域には、設計上チェックディジットが含まれています。ShieldIDは、MRZから読み取った項目を信頼できるものとして扱う前に、これらを検証します。
専用の検出器がMRZの位置を特定し、読み取り機能が文字を抽出して、その結果を領域自身のチェックサム計算式に照らして有効性をスコア化します。最低限の有効性スコアを満たした項目のみが最優先で信頼され、読み取り状態の悪い領域は、問題なく読み取れたかのようにそのまま通されることなく、それに応じて扱われます。
バーコード優先
情報源が重複する場合は、最も信頼性の高いものが優先されます。
同じ項目が、バーコード、MRZ、券面の印字のいずれにも現れることがあります。ShieldIDは、常に一貫した順序でこれを解決します。
- PDF417バーコード
- パスポートのMRZ(チェックサムに合格した場合)
- 券面の印字の構造化読み取り
- 全ページOCRによるフォールバック
住所確認書類
2つ目の書類をアップロードするだけで、住所をわかりやすく照合できます。
本人確認で住所確認が必要な場合、申請者は別の書類をアップロードし、ShieldIDは身分証と同じ方法でその書類を読み取ります。
住所確認書類はOCRにかけられ、その住所が身分証から読み取った住所と照合されます。これは単純なテキストとトークンの比較であり、別個の書類分類器ではありません。セッションで必要とされ、かつ実際に書類が提出された場合にのみ実行されます。
秘匿化とPIIの取り扱い
抽出されたデータは、画像と同じように保護されます。
構造化された項目にも、身分証の画像そのものに適用されるのと同じプライバシー保護が適用されます。
生年月日は保存時に暗号化
生年月日は暗号化された状態で保存されます。暗号鍵が設定されていない場合、サービスは動作しません。
画像はタイマーで消去
撮影された書類と自撮りの画像は、短いタイマーに従って自動的に消去されます(デフォルトは7日間)。消去処理は一定間隔で実行され、再起動の直後にも再度実行されるため、本来削除されるべき日を過ぎて画像が残ることはありません。
端末上でのスコアの秘匿化
一致度や信頼度の数値が申請者自身のスマートフォンに表示される場合、ShieldIDは表示前にメッセージから元のパーセンテージを取り除くため、生のスコアがお客様のアカウントの外に表示されることはありません。
記録は画像より長く残ります
画像はスケジュールに従って削除されます。本人確認が行われたという事実とその結果は、お客様のアカウントに残ります。また、Trust Ledgerとの連携では、Activity Ledgerに検証済み/失敗のエントリとして記録されます(ShieldID APIアカウントのレジャーエントリ:近日公開)。
サンプル結果
APIが返す形式での、フィールドごとの判定です。
以下の氏名、番号、住所はこの例のために作成した架空のものです。フィールドの構成、取得元、判定は、実際の結果と同じ形式です。
| フィールド | 値 | 取得元 | 判定 |
|---|---|---|---|
| person.name | "Maria Gonzalez" | barcode | match |
| person.dob | "1991-07-22" | barcode | match |
| person.document_number | "D1234567" | barcode | match |
| person.document_country | "US" | barcode issuer code | match |
| person.address | "1428 Elm St, Sacramento, CA" | barcode | match |
| identity.name_match | PASS | front vs barcode vs requester | PASS |
| checks.document_tamper | "no_indication" | advisory model | advisory, not gating |
// Sample result. Names, numbers and addresses are fictional.
{
"session_id": "ses_9f2c...sample",
"status": "VERIFIED",
"environment": "sandbox",
"person": {
"name": "Maria Gonzalez",
"dob": "1991-07-22",
"document_type": "DRIVERS_LICENCE",
"document_country": "US",
"document_jurisdiction": "CA",
"address": "1428 Elm St, Sacramento, CA"
},
"identity": {
"checks": ["name_match"],
"warnings": [],
"sources": {
"name": "barcode",
"dob": "barcode",
"address": "barcode"
}
},
"checks": {
"document": "PASS",
"identity": "PASS",
"document_tamper": "no_indication"
},
"completed_at": "2026-09-17T14:02:11Z"
}連携に関する注意事項
結果をどこで読み取っても、同じフィールド。
構造化フィールドは、本人確認セッションとは別の製品ではありません。同じ結果の一部として届きます。
- フィールドは、本人確認の完了後にAPI経由で取得するセッション結果に含まれて提供されます。
- 本人確認が完了すると、同じ結果が署名付きWebhookでお客様のエンドポイントに届けられるため、ポーリングする必要はありません。
- すべてのフィールドには情報源が紐づけられ、個別の判定が付いています。これはAPIの結果でもWebhookのペイロードでも同じです。
- Sandboxセッションは本番環境と同じフィールド形式を返すため、実際の書類を一度も読み取る前に連携を構築できます。
ご質問
データ抽出についての率直なお答え。
フィールドをご自身でお確かめください
sandboxで本人確認を実行し、構造化された結果をご覧ください。
sandboxセッションを作成し、お手持ちのスマートフォンで書類をスキャンして、すべてのフィールド、その情報源、判定をレスポンスでご確認ください。Sandboxセッションに課金されることはありません。