マイナンバーカード一括取得API
概要
ご利用料金について
画像のテキスト変換について
取得できる項目
アクセスコントロール
処理の流れ
セッションの作成（サービスプロバイダ事業者）
内部認証を行う場合は、APIでセッションを作成し、内部認証に使用するセッションIDと乱数を取得します。セッションは作成から10分間有効で、1回だけ使用できます。
暗証番号または照合番号の入力要求（サービスプロバイダ事業者）
読み取るAPに対応する暗証番号または照合番号の入力を、利用者に要求します。
暗証番号または照合番号の入力（利用者）
利用者が暗証番号または照合番号を入力します。SDKの券面OCR機能により、スマートフォンのカメラで照合番号の自動読み取りが可能です。
情報
マイナンバーカードのデータ取得（サービスプロバイダ事業者）
SDKを利用してマイナンバーカードのICチップを読み取り、入力された暗証番号または照合番号で、指定したAPのデータをまとめて取得します。内部認証を行う場合は、SDKにセッションを指定します。券面APと券面事項入力補助APでは、ICチップがセッションの乱数に署名します。取得したデータは、署名検証や有効性確認、利用可能な形式への変換を行うために、APIで送信します。
署名検証・有効性確認（プラットフォーム事業者）
APIで送信されたデータから、APごとに電子署名を取得し、署名を検証して真贋判定を行います。署名検証後は、公的個人認証APの電子証明書の有効性確認を行います。また、券面APの有効期限とマイナ免許APの有効期間の末日を当日の日付と比較し、期限内であることを確認します。内部認証を行う場合は、ICチップが乱数に対して作成した署名を検証し、複製されたカードでないことを確認します。
カードの情報返却（プラットフォーム事業者）
署名検証および有効性確認後、取得したカード情報をAPごとに利用可能な形式へ変換し、サービスプロバイダ事業者へ返却します。取得項目を選択している場合は、対象の項目のみ返却されます。
シーケンス図
実装例
iOS
Android