# 基本4情報提供API

<br>

## **概要**

基本4情報提供APIは、予め利用者の同意を得て、最新基本4情報（氏名・住所・生年月日・性別）を取得するためのAPIです。
プラットフォーム事業者がJ-LISより基本4情報（氏名・住所・生年月日・性別）を受け、サービスプロバイダ事業者はプラットフォーム事業者を経由して間接的に提供を受け取ります。
これにより、サービスプロバイダ事業者において、利用者の基本4情報（氏名・住所・生年月日・性別）を取得できるため、郵送物等の不着削減が可能となるほか、利用者においてもサービスプロバイダ事業者に対し住所変更手続等が不要となります。

## **取得できる項目**
<AccordionGroup>
    <Accordion title="基本4情報（氏名・住所・生年月日・性別）">
        - 氏名（例：姓名／フリガナ）
        - 住所
        - 生年月日
        - 性別
    </Accordion>
</AccordionGroup>
    

## **処理の流れ**

<Steps>
    <Step title="基本4情報（氏名・住所・生年月日・性別）の取得要求（サービスプロバイダ事業者）">
        利用者の署名用電子証明書に紐づく利用者IDまたは電子証明書IDを指定して、APIでリクエストを送信します。
    </Step>
    <Step title="署名用電子証明書の取得（プラットフォーム事業者）">
        受信したIDに該当する署名用電子証明書をデータベースより取得します。
    </Step>
    <Step title="基本4情報（氏名・住所・生年月日・性別）の取得（プラットフォーム事業者）">
        署名用電子証明書に該当する基本4情報（氏名・住所・生年月日・性別）取得をJ-LISに対して要求し、利用者の同意情報が存在する場合は、それに該当する基本4情報が返却されます。
    </Step>
    <Step title="基本4情報（氏名・住所・生年月日・性別）の返却（プラットフォーム事業者）">
        J-LISから返却された基本4情報（氏名・住所・生年月日・性別）をサービスプロバイダ事業者に返却します。
    </Step>
</Steps>
    
## **シーケンス図**

```mermaid
    %%{init:{'theme':'natural'}}%%
    sequenceDiagram
    participant 利用者
    participant SDK
    participant サービスプロバイダ事業者
    participant プラットフォーム事業者
    participant J-LIS
    
    alt 
        サービスプロバイダ事業者->>プラットフォーム事業者: 利用者IDを送信
    else
        サービスプロバイダ事業者->>プラットフォーム事業者: 電子証明書IDを送信
    end
    プラットフォーム事業者->>プラットフォーム事業者: データベースから署名用電子証明書を取得
    プラットフォーム事業者->>J-LIS: 署名用電子証明書の送信
    J-LIS->>J-LIS: 同意状況の確認
    alt 同意取得済みの場合
        J-LIS->>プラットフォーム事業者: 該当する基本4情報（氏名・住所・生年月日・性別）を取得
        プラットフォーム事業者->>サービスプロバイダ事業者: 基本4情報（氏名・住所・生年月日・性別）の返却
    else 同意未取得・取消し済みの場合
        J-LIS->>プラットフォーム事業者: 取得できなかった理由を返却
        プラットフォーム事業者->>サービスプロバイダ事業者: 取得できなかった理由を返却
    end
```

<br>