Sansan名刺検索
概要
Sansanの名刺APIを利用して、指定した条件（氏名や会社名）で名刺情報を検索します。 Sansan APIを利用する場合、API Keyの取得が必要です。
事前準備
Sansan APIを利用する場合、API Keyの取得が必要です。 バインダを用意し、以下の部品を追加します。
| 項目名 | 部品タイプ |
|---|---|
| 検索氏名 | 文字列入力ボックス |
| 検索会社名 | 文字列入力ボックス |
| 名刺検索 | アクション部品 |
| 姓 | 文字列入力ボックス |
| 名 | 文字列入力ボックス |
| 会社名 | 文字列入力ボックス |
| 部署 | 文字列入力ボックス |
| 役職 | 文字列入力ボックス |
| 文字列入力ボックス | |
| 〒 | 文字列入力ボックス |
| 住所 | 文字列入力ボックス |
設定のサンプル
アクション部品（外部API連携）のサンプルです。
表 リクエスト項目の設定内容
| 設定項目 | 設定値 |
|---|---|
| メソッド | 「GET」を選択 |
| URL | 「https://api.sansan.com/v2.0/bizCards/search?entryStatus=completed&orderBy=registeredAt&orderDirection=desc&limit=100&range=all&name=$contents.get(部品ID_1).value&companyName=$contents.get(部品ID_2).value」を入力 ※事前準備で用意した検索氏名および検索会社名の部品IDを指定 |
| 認証 | なし |
| Content-Type | 「application/x-www-form-urlencoded; charset=UTF-8」を選択 |
| ヘッダ | X-Sansan-Api-Key=API Key ※API Keyには事前準備で取得したAPI Keyを指定 |
表 レスポンス項目の設定内容
| 設定項目 | 設定値 |
|---|---|
| 文字セット | 指定なし |
| 単一レコード/複数レコード | 「複数レコード」を選択 |
| 複数レコード抽出方法 | 「JsonPath」を選択 |
| 抽出詳細 | 「$.data」を入力 |
| レコード単位の設定 | ※下表のレコード単位の設定内容を参照 |
表 レスポンス項目のレコード単位の設定内容
| 対象部品 | 抽出方法 | 抽出詳細 | 表示 | タイトル |
|---|---|---|---|---|
| 事前準備で用意した姓を選択 | JsonPath | $.lastName | チェック | 姓 |
| 事前準備で用意した名を選択 | JsonPath | $.firstName | チェック | 名 |
| 事前準備で用意した会社名を選択 | JsonPath | $.companyName | チェック | 会社名 |
| 事前準備で用意した部署を選択 | JsonPath | $.departmentName | チェック | 部署名 |
| 事前準備で用意した役職を選択 | JsonPath | $.title | チェック | 役職 |
| 事前準備で用意したEmailを選択 | JsonPath | |||
| 事前準備で用意した〒を選択 | JsonPath | $.postalCode | ||
| 事前準備で用意した住所を選択 | JsonPath | $.address |