運転免許証API
概要
運転免許証の場合は設定されている暗証番号1および暗証番号2、マイナ免許証の場合はマイナ免許証の暗証番号を入力することで、運転免許証またはマイナ免許証の情報を全て取得します（取得項目は選択可能です）。また、運転免許証またはマイナ免許証に格納されている電子署名を検証することで真贋判定を行い、有効期間の末日と当日の日付を比較することで、有効性確認も同時に行います。真贋および有効性が確認できた場合、運転免許証またはマイナ免許証の情報を取得できます。
マイナ免許証には、氏名・生年月日・住所・性別の基本4情報が格納されていないため、取得するには別途、券面事項入力補助APIを利用する必要があります。券面事項入力補助APIの詳細はこちらからご覧ください。
また、運転免許証には、性別情報が記載されていないため、取得できません。
取得できる項目
アクセスコントロール
処理の流れ
対面
非対面
運転免許証・マイナ免許証のデータ取得（サービスプロバイダ事業者）
SDKを 利用して運転免許証またはマイナ免許証のICチップを読み取り、利用者が入力した運転免許証またはマイナ免許証の暗証番号を利用することで、運転免許証またはマイナ免許証のデータを取得します。取得したデータは、署名検証・有効性確認・利用可能な形式への変換を行うため、APIで送信します。
運転免許証・マイナ免許証の署名検証・有効性確認（プラットフォーム事業者）
APIで送信されたデータより電子署名を取得し、署名検証による真贋判定を行います。署名検証後は、運転免許証の有効期間の末日と当日の日付を比較し、有効性確認を行います。いずれかの処理が異常終了した場合、運転免許証またはマイナ免許証の情報は取得されず、署名検証および有効性確認の結果のみを返却します。
運転免許証・マイナ免許証の情報取得（プラットフォーム事業者）
署名検証および有効性確認が正常に完了した場合、運転免許証またはマイナ免許証の情報を利用可能な形式に 変換し、サービスプロバイダ事業者へ返却します。取得項目を選択している場合は、対象の項目のみ返却されます。
シーケンス図
対面
非対面
実装例
iOS
Android
React Native
Windows