> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# セッション共有API：パートナー間で再利用できるKYC

> DiditのセッションシェアAPIなら、認証済みのKYC・KYBセッションを期限付きトークンで信頼できるパートナーと共有できます。再検証を省き、ユーザーの手間とコストを削減します。

再利用可能なKYCおよびKYBは、Share Session APIで実現できます。このAPIは、信頼できるパートナー組織間で検証済みのセッションデータを安全に共有します。ユーザー認証(KYC)と法人確認(KYB)のどちらのセッションにも対応しています。共有トークンには`session_kind`がエンコードされているため、受け取る側のアプリケーションはインポート時に同じ種類のセッションを再構築します。

## エンドポイント

> [card] [セッションの共有](https://docs.didit.me/ja/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/`:検証済みのセッションに対して、有効期限付きの共有トークンを生成します。

> [card] [共有セッションのインポート](https://docs.didit.me/ja/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/`:パートナーが共有したセッションを、共有トークンを使ってインポートします。

## 仕組み

**1. パートナーAがセッションを共有する**

ユーザーがパートナーAのプラットフォームで認証を完了した後、パートナーAはセッションIDと共有先パートナーのアプリケーションIDを指定して**セッションの共有**を呼び出します。Diditは有効期限付きの`share_token`を返します。

**2. 共有トークンをパートナーBに送る**

パートナーAは、自社の安全なチャネル(API呼び出し、Webhookなど)を通じて`share_token`をパートナーBに送ります。

**3. パートナーBがセッションをインポートする**

パートナーBは`share_token`を指定して**共有セッションのインポート**を呼び出します。Diditは、認証済みセッションのコピーを、すべての認証データを含めてパートナーBのアカウントに作成します。

## 要件

| 要件 | 詳細 |
| - | - |
| **セッションのステータス** | 共有できるのは完了したセッション(`"Approved"`、`"Declined"`、`"In Review"`)のみです |
| **パートナーのアプリケーションID** | 共有先パートナーのアプリケーションID(Business Consoleの設定で確認できます) |
| **トークンのTTL** | 60秒から86,400秒(24時間)の範囲で設定できます。デフォルトは3,600秒(1時間)です |
| **認証** | 両パートナーとも、それぞれ自社のAPIキーで認証する必要があります |

## ユースケース

* **銀行 → フィンテック**:銀行で認証済みのユーザーが、再認証なしでフィンテックパートナーのサービスを利用できます
* **マーケットプレイス → 決済事業者**:マーケットプレイスで認証済みの出品者が、決済事業者に即座にオンボーディングできます
* **保険 → ヘルスケア**:信頼できるパートナー間で、業界をまたいで認証結果を共有できます
* **グループ企業**:同じ組織内の複数のアプリケーション間で認証データを共有できます

> [!NOTE]
>
> 再利用可能なKYC機能の詳細は、[APIによるKYC共有ガイド](https://docs.didit.me/ja/core-technology/reusable-kyc/share-kyc-via-api.md)をご覧ください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.