JPKIPittari

POST

/v6/pittari/request

本APIを利用することで、マイナポータルを利用するユーザーが、xIDで公的個人認証を実施できるようになります。
対象となる署名値が複数存在する場合は、一括で署名を付します。

リクエストパラメータ

Authorization

Headerにパラメータ

Authorization

を追加し、その値にはBearerの後にTokenを連結します

例：

Authorization: Bearer ********************

リクエストボディパラメータapplication/json

例

レスポンス

🟢200OK

application/json

Request created successfully

ボディapplication/json

🟠400不正な要求

🟠401権限なし

🔴500サーバーエラー

リクエストExample

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.x-id.io/v6/pittari/request' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "primary_bytes": "/8Sh6xef604iedYjkqN0BnQ2ycFlNmvxNw0tsIk9SFo=",
    "reason": "〇〇のため公的個人認証を行なってください。",
    "isDigest": false,
    "notification_title": "公的個人認証のリクエストが届いています",
    "notification_description": "〇〇サービスから公的個人認証の要求が届いています。xIDアプリを開いて公的個人認証を行なってください。",
    "callback_url": "https://xid.inc"
}'

レスポンスExample

200 - 成功レスポンス

{
    "expires_in": 1757568777,
    "is_renewed": false,
    "request_id": "1927ed6757701efc586d8f5d5c9a79c7318ed7f84e782e2f"
}

更新日時 2026-05-11 23:16:37

JPKI Pittari APIの変更点概要

JPKIPittariRedirect