API Docs
v5.9.0
  • v5.9.0
  • v6.1.0
ガードAPI仕様
よくある質問
ガードAPI仕様
よくある質問
v5.9.0
  • v5.9.0
  • v6.1.0
v5.9.0
  • v5.9.0
  • v6.1.0
  1. マイナポータル向け公的個人認証API
  • APIの概要
  • システム構成
  • 認証&認可API
    • 概要
    • Authorization
      GET
    • Token
      POST
    • Userinfo
      GET
  • 本人確認API
    • 概要
    • Userdata
      GET
  • 電子署名API
    • 概要
    • Signing
      POST
    • SigningStatus
      GET
    • Certificate
      GET
    • SigningCallback
      POST
  • マイナンバーAPI
    • 概要
    • MyNumber
      POST
    • MyNumberStatus
      GET
  • 本人確認情報更新API
    • 概要
    • Re:Verification
      POST
    • Re:VerificationStatus
      GET
    • Re:VerificationCallback
      POST
  • 公的個人認証API
    • 概要
    • JPKI
      POST
    • JPKIStatus
      GET
    • JPKICallback
      POST
  • マイナポータル向け公的個人認証API
    • 概要
    • JPKIPittari
      POST
    • JPKIPittariCallback
      POST
  • 利用者証明用証明書シリアルAPI
    • 概要
    • Serial
    • SerialCallback
  • 券面事項入力補助API
    • 概要
    • CardInput
    • CardInputStatus
    • CardInputCallback
  1. マイナポータル向け公的個人認証API

概要

本APIは以下のエンドポイントで構成されています。
JPKIPittari(利用者へのマイナポータル向け公的個人認証リクエストを発行する)
JPKIPittariCallback(利用者のモバイル端末へのマイナポータル向け公的個人認証リクエストを発行する)
本APIを利用することで、マイナポータルを利用するユーザーが、xIDで公的個人認証を実施できるようになります。対象となる署名値が複数存在する場合は、一括で署名を付します。
注意
JPKIやJPKIStatusの仕様とは異なり、本プロセスにおいてxIDからBizPICOに対して署名検証のリクエストは実施せず、署名値や証明書はバイパスします。 よって、カードの状態(有効・失効・有効期限切れ)の確認や基本四情報による認証者本人のカードであることの確認は行いません。必要に応じて、クライアントサービス側での検証を行なってください。

JPKIPittariについて#

シーケンス#

利用者フロー#

pittari-flow.png

JPKIPittariCallback#

JPKIPittariとの違い#

JPKIPittariとの違いは主に下記の2点です。
本エンドポイントを用いてマイナポータル向け公的個人認証を実施した場合、自動的にxIDアプリへ遷移して公的個人認証が開始されます
当該認証が完了した後、本リクエストを実行したクライアントアプリに自動的に戻ります
xIDアプリから自動遷移して戻る先は、デフォルトブラウザがターゲットとなります。特定のアプリへ遷移が必要な場合は、クライアントアプリ側でユニバーサルリンク、アプリリンクを用いて、そちらをcallback_urlに指定することをご検討ください。

リクエスト元からxIDアプリへの自動遷移#

レスポンスに含まれるredirect_urlを呼び出していただくことで、xIDアプリに自動遷移し公的個人認証が開始されます。

xIDアプリからリクエスト元への自動遷移#

公的個人認証の手続き終了後は、リクエスト時に指定されたURLへ自動遷移いたします。その際、当該手続きのステータス( certificate_verified・certificate_invalid ・canceled)が付与されるので、ステータスに応じてリクエスト元でクライアントに表示する画面を制御することができます。

シーケンス#

利用者フロー#

pittari-mobile-flow.png
更新日時 2026-06-04 09:37:09
前へ
マイナポータル向け公的個人認証API
次へ
JPKIPittari
Built with