JPKIPittariRedirect
テスト中
POST
/v6/pittari/redirect/request
マイナポータルを利用するユーザーが、xIDで公的個人認証を実施できるようになります。対象となる署名値が複数存在する場合は、一括で署名を付します。
利用者のxIDアプリでの公的個人認証の操作が終わると、その結果（status）と request_id, signature, certificateがクライアントアプリのcallback_urlに渡されます。callback_urlへの応答についてはcallback_urlへの応答にて詳細をご確認ください
自動遷移の際、xIDアプリは redirect_url に対して、以下の形式でパラメーターをGETメソッドで渡します。セキュリティの観点から署名値や証明書は付与せず、結果ステータスのみを渡します。
client_redirect_url への応答例
https://example.com/mobile?request_id=ilOAn2yR9T0IgRgxX...Y4k0ZEwyV9-vlkmOmp01NzoRST1&state=lefzb8pcgb&status=succeeded
リクエストパラメータ
リクエストボディパラメータapplication/json
レスポンス
リクエストリクエストExample
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-uat.x-id.io/v6/pittari/redirect/request' \
--header 'Content-Type: application/json' \
--data-raw '{
"primary_bytes": "/8Sh6xef604iedYjkqN0BnQ2ycFlNmvxNw0tsIk9SFo=",
"is_digest": true,
"reason": "test reason",
"callback_url": "https://nifty-maintainer.info/",
"redirect_url": "https://shallow-abacus.name/",
"state": "{{$string.uuid}}"
}'レスポンスレスポンスExample
200 - example-1
{
"request_id": "req123",
"expires_in": 3600,
"is_renewed": false,
"redirect_url": "http://example.com/redirect"
}更新日時 2025-09-10 06:31:21