メインコンテンツへスキップ
POST
curl

KYCとKYBのサポート

本人確認(KYC)と法人確認 (KYB)のどちらのセッションにも対応しています。Didit はsession_idに対応するセッションを両方のセッション種別から特定し、次の内容を含むJWT共有トークンを生成します。
受け取り側のパートナーがトークンをインポートすると、Didit は該当する種別のセッション(KYCまたはKYB)を関連データとともに複製します。

要件

  • セッションが完了ステータス(APPROVED、DECLINED、IN_REVIEW)である必要があります。
  • write:sessions権限が必要です。
  • for_application_idは有効なDiditアプリケーション(通常はパートナーのアプリケーション)である必要があります。

例

レスポンス:

TTLの範囲

関連情報

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

sessionId
string<uuid>
必須

トークンを発行する元の検証セッションのUUID。

例:

"11111111-2222-3333-4444-555555555555"

ボディ

application/json
for_application_id
string<uuid>
必須

トークンを利用するDiditアプリケーションのUUIDです。存在し、削除されておらず、かつ呼び出し元アプリケーションとは異なる必要があります。Business ConsoleのSettings → Applicationで確認できます。

例:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
デフォルト:3600

トークンの有効期間(秒)。最小は60、最大は86400(24時間)です。デフォルトは3600(1時間)です。

必須範囲: 60 <= x <= 86400
例:

3600

レスポンス

共有トークンが発行されました。

share_token
string

HS256で署名されたJWT。対象のアプリケーションで、POST /v3/session/import-shared/にshare_tokenとしてそのまま渡してください。

例:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

トークンが紐づく対象アプリケーションのUUIDをそのまま返します。

例:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

元のセッションがユーザー認証(KYC)セッションか法人確認(KYB)セッションか。

利用可能なオプション:
user,
business
最終更新日 2026年11月1日