xID Lite API Doc
ガイドAPI仕様
よくある質問リリースノート
ガイドAPI仕様
よくある質問リリースノート
  1. 公的個人認証 + 券面検証API
  • APIの概要
  • システム概要
  • 公的個人認証 + 券面検証API
    • 概要
    • CFJPKI
      POST
    • CFJPKI Status
      GET
    • CFJPKI Redirect
      POST
  • 運転免許証検証API
    • 概要
    • DLC
      POST
    • DLC Status
      GET
    • DLC Redirect
      POST
  1. 公的個人認証 + 券面検証API

CFJPKI Redirect

POST
/{{version}}/cfjpki/redirect/request
クライアントサイドのコールバックを利用してモバイルフローの検証リクエストを開始し、利用者のxIDLiteアプリに対して公的個人認証+券面検証の実施要求を送信します。
利用者の操作状況はJPKIStatusで確認できます。

リクエストパラメータ

Authorization
Headerにパラメータ
Authorization
を追加し、その値にはBearerの後にTokenを連結します
例:
Authorization: Bearer ********************
リクエストボディパラメータapplication/json必須

例
{
  "bytes": "n4bQgYhMfWWaL+qgxVrQFaO/TxsrC4Is0V1sFbDwCgg=",
  "is_digest": true,
  "reason": "マイナンバーカードを使用して〇〇銀行の口座を開設するため、公的個人認証および券面検証を実施してください。",
  "verifier_cd": "{{devVerifiedCd}}",
  "service_id": "{{devServiceId}}",
  "verifier_password": "{{devVerifierPassword}}",
  "company_name": "xID株式会社",
  "company_icon": "https://public.xid.inc/logo.png",
  "company_policy": "https://example.com/privacy-policy",
  "nacl_public_key": "EtJoMvFl/naFUUIGUUT89hmp6RM+n6xS5+aPc9z4dwU=",
  "client_redirect_url": "https://x-id.me/",
  "state": "{{onetimeCfjpkiRedirectState}}"
}

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

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
リクエストリクエストExample
Shell
JavaScript
Java
Swift
curl --location --globoff '/{{version}}/cfjpki/redirect/request' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "bytes": "n4bQgYhMfWWaL+qgxVrQFaO/TxsrC4Is0V1sFbDwCgg=",
  "is_digest": true,
  "reason": "マイナンバーカードを使用して〇〇銀行の口座を開設するため、公的個人認証および券面検証を実施してください。",
  "verifier_cd": "{{devVerifiedCd}}",
  "service_id": "{{devServiceId}}",
  "verifier_password": "{{devVerifierPassword}}",
  "company_name": "xID株式会社",
  "company_icon": "https://public.xid.inc/logo.png",
  "company_policy": "https://example.com/privacy-policy",
  "nacl_public_key": "EtJoMvFl/naFUUIGUUT89hmp6RM+n6xS5+aPc9z4dwU=",
  "client_redirect_url": "https://x-id.me/",
  "state": "{{onetimeCfjpkiRedirectState}}"
}'

レスポンス

🟢200成功
application/json
Request created successfully
ボディapplication/json

例
{
    "expires_in": 600,
    "redirect_url": "https://lite-redirect-dev.x-id.io/?poll_token=v4.local.s-EkGjsebp...jh2U4r2D9Q&request_type=cfjpki_redirect",
    "request_id": "9ccad7934e...58f3847779"
}
🟠400不正リクエスト
🟠401認証なし
更新日時 2026-08-18 00:10:10
前へ
CFJPKI Status
次へ
運転免許証検証API
Built with