JPKICallback

API-Document

https://api-uat.x-id.io

POST

/v5/jpki/callback/request

本APIはモバイル端末での利用を想定しています。
利用者にxIDアプリによる公的個人認証の実施をリクエストします。
利用者の操作状況はJPKIStatusにて確認できます。

リクエストパラメータ

Authorization

Headerにパラメータ

Authorization

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

例：

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

Headerパラメータ

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

例

{
    "bytes": "/8Sh6xef604iedYjkqN0BnQ2ycFlNmvxNw0tsIk9SFo=",
    "is_digest": true,
    "reason": "〇〇市における住民票交付申請を行うために公的個人認証を実施してください。〇〇サービスで入力して頂いた申請情報にマイナンバーカードの署名用電子証明書による電子署名を行い、送信します。",
    "callback_url": "https://xid.inc",
    "state": "{{$guid}}"
}

リクエストコードサンプル

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api-uat.x-id.io/v5/jpki/callback/request' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "bytes": "/8Sh6xef604iedYjkqN0BnQ2ycFlNmvxNw0tsIk9SFo=",
    "is_digest": true,
    "reason": "〇〇市における住民票交付申請を行うために公的個人認証を実施してください。〇〇サービスで入力して頂いた申請情報にマイナンバーカードの署名用電子証明書による電子署名を行い、送信します。",
    "callback_url": "https://xid.inc",
    "state": "{{$guid}}"
}'

レスポンス

🟢200成功

application/json

ボディapplication/json

例

{
    "request_id": "string",
    "redirect_url": "string",
    "expires_in": 0
}

🟠400不正リクエスト

🟠401認証なし

🔴500サーバー内部エラー

更新日時 2026-06-02 08:31:43

JPKIStatus

マイナポータル向け公的個人認証