最新の基本４情報取得

ここでは、Verify API を使用して同意を行った利用者の最新の基本４情報の取得を行う方法を説明します。

あらかじめAPI の利用開始を完了し、API トークンを取得しておいてください。

注意

テナントを作成した段階では、最新の基本４情報の取得に関係する API は無効化されているため利用できません。

利用するにはお問い合わせください。

シーケンス

実装例

クライアントライブラリのセットアップ方法は、クライアントライブラリをご参照ください。

Go
TypeScript
Kotlin
Swift

package main

import (
	"context"
	"fmt"
	"log"
	"net/http"

	"buf.build/gen/go/pocketsign/apis/connectrpc/go/pocketsign/verify/v2/verifyv2connect"
	verifyv2 "buf.build/gen/go/pocketsign/apis/protocolbuffers/go/pocketsign/verify/v2"
	"connectrpc.com/connect"
)

var (
	// APIエンドポイントを指定します。この値は環境によって異なります。
	baseUrl = "https://verify.mock.p8n.app"

	// Verify APIのトークンです。ご自身のトークンに置き換えてください。
	token = "<YOUR_API_TOKEN>"

	// 同意を取得する利用者の証明書IDです。これは、同意時や署名検証時に取得できます。
	certificateID = "53e8bf1c-44ef-4a48-b02b-cfad42e1ceda"
)

func run() error {
	// 最新の基本４情報取得リクエストを作成します。
	request := connect.NewRequest(&verifyv2.FetchLatestCertificateContentRequest{
		CertificateId: certificateID,
	})

	// リクエストにAPIトークンを設定します。
	request.Header().Set("Authorization", "Bearer "+token)

	// APIクライアントを作成します。
	client := verifyv2connect.NewCertificateServiceClient(http.DefaultClient, baseUrl)

	// 最新の基本４情報取得リクエストを送信します。
	response, err := client.FetchLatestCertificateContent(context.Background(), request)
	if err != nil {
		return err
	}

	// 結果を表示します。
	latestCertContent := response.Msg.GetLatestCertificateContent().GetJpkiCardDigitalSignatureContent()
	fmt.Printf("CommonName: %s\n", latestCertContent.CommonName)
	fmt.Printf("Address: %s\n", latestCertContent.Address)
	fmt.Printf("DateOfBirth: %s\n", latestCertContent.DateOfBirth)
	fmt.Printf("Gender: %s\n", latestCertContent.Gender)
	return nil
}

func main() {
	if err := run(); err != nil {
		log.Fatalln(err)
	}
}

リクエストに成功すると、以下のように結果が表示されます。

JPKIPersonalInfo:
CommonName: 原　智子
Address: 北海道厚岸郡浜中町円朱別西七線６９０８番９９９９号
DateOfBirth: 118991201
Gender: 2

注意

現在、最新の基本４情報の取得を行う API はプレリリース版となっています。通常のクライアントはご利用いただけません。詳しくはお問い合わせください。

注意

現在、モック環境における最新の基本４情報の取得は利用できません。

次のステップ

その他、API の詳しい使い方やエラーの詳細等については、API リファレンスをご覧ください。

シーケンス​

実装例​

次のステップ​

シーケンス

実装例

次のステップ