はじめに

この度は、Web電話帳「PHONE APPLI PEOPLE」（以降「PA PEOPLE」と表記します）をご利用いただきまして、誠にありがとうございます。

本書は PA PEOPLE との機能・サービス連携用 API の設定方法を記載しています。

APIについては「PHONE APPLI API仕様書 open_in_new 」をご参照ください。

1. 管理者設定

※ 以降 PHONE APPLI API を「PA API」と表記します。

PA APIをご利用いただくにあたっての設定事項です。

  • ユーザの API利用権限 を有効にする

  • IPアドレス制限をする

1.1. ユーザのAPI利用権限を有効にする

PA APIご利用対象のユーザ（基本利用ユーザ）に対して「API利用権限」を有効にします。

1.1.1. WebUI で設定する

  1. ［管理］＞［ユーザ］タブ＞［ユーザ管理］タブ＞PA APIを有効にするユーザを選択します。

  2. ［基本情報］タブ＞「API利用権限」項目を有効にします。

image

1.1.2. ユーザインポートで設定する

ユーザデータのインポートファイル（TSV（タブ区切り）形式）のカラムに設定値を指定して、インポート処理で一括登録できます。

※ 列を省略してインポートした場合は無効になります。インポートの詳細手順は「PHONE APPLI PEOPLE 管理者ガイド」ユーザ管理 をご参照ください。

ヘッダー項目名 設定値

PAAPI_AVAILABLE

有効: 1 , 無効: 0 または 空白

1.2. IPアドレス制限をする

PA APIの利用を許可するIPアドレスを制限できます。

※ API利用権限を付与されたユーザが利用できます。

［管理］＞［企業情報］タブ＞［社内/ロゴ］タブを開き、「IPアドレス制限」欄で設定します。

※ 設定手順の詳細は、「PHONE APPLI PEOPLE 管理者ガイド」IPアドレス制限をする をご参照ください。

image

 

追加 / 編集

image

1.3. ログを出力する

※ 本操作にはログ出力権限が必要です。

APIに関するログをTSV（タブ区切り）形式のファイルで出力できます。

  1. 画面右上のユーザ名＞［管理］＞［ログ出力］タブ＞［PHONE APPLI API ログ］タブを開きます。

  2. 任意の期間（ログ保存期間内）を指定し、出力するログタイプ欄の［エクスポート］をクリックします。

image

ログの詳細については次のとおりです。

  • ログタイプ

    ログタイプ 概要

    API実行ログ

    実行されたAPIのログ
    ※ APIの実行が成功した場合に限り取得できます。
    ※ 保持期間: 90日（90日前の0:00以降のログを保持）

    APIキー管理ログ

    APIキーを発行/編集/再発行/削除したときのログ
    ※ 保持期間: 1年（今日の日付の1年前の0:00以降のログを保持）
    　 例: 今日が2023/03/10の場合、2022/03/10 0:00以降が対象

  • 出力項目

    API実行ログ
    項目名 概要

    日時

    APIを実行した日時

    APIキーID

    APIキーのID

    ユーザ

    APIを実行したユーザのログインID

    IPアドレス

    APIを実行した送信元IPアドレス

    メソッド

    APIを実行したときの通信リクエストの方式（GET/POST/PUT/DELETE/PATCH）

    パス

    実行したAPIのパス

    クエリパラメータ

    実行したAPIのクエリパラメータ

    実行結果

    APIの実行結果
    APIキー管理ログ
    項目名 概要

    日時

    APIキーを発行/編集/再発行/削除した日時

    APIキーID

    APIキーのID

    ユーザ

    APIキーを発行/編集/再発行/削除したユーザのログインID

    IPアドレス

    APIキーを発行/編集/再発行/削除した送信元IPアドレス

    アクション

    APIキー管理の種別

    • 発行: Generate

    • 編集: Edit

    • 再発行: Regenerate

    • 再発行による削除: Deletion by Regenerate

      • ※ 再発行により以前のキーが削除されるため、削除の操作がなくても出力されます。

    • 削除: Delete

    ノート

    APIキーのノート

    有効期限

    APIキーの有効期限

    権限範囲

    APIキーの権限範囲

2. APIキー設定

※ 本設定にはAPI利用権限が必要です。

2.1. APIキーを発行する

  1. 画面右上のユーザ名＞［ユーザ情報］タブ＞［APIキー］タブを開きます。

  2. 「ノート」欄に任意の内容を入力し、「有効期限」（30日/60日/90日/無制限）と任意で「権限範囲」を選択後、発行します。

    設定 - APIキー（発行）

    • ※ 「ノート」欄が未入力の場合、キー発行日時が入力されます。

    • ※ 権限範囲「User.Write」「Division.Write」「ExternalContacts.Write」にチェックを入れると、それぞれに読み取り権限も付与されます。

  3. APIキーが一覧に表示されます。

    設定 - APIキー（コピー）

    • ※ 発行直後に限り［］をクリックして発行したキーをクリックボードにコピーできます。

2.2. APIキーを管理する

2.2.1. 編集する

  • ノート
    ［］をクリック＞入力欄を編集し、保存します。
    　※ 「ノート」欄にカーソルを乗せるとアイコンが表示されます。

    設定 - APIキー（ノート）

  • 権限範囲
    ［］をクリック＞権限範囲欄の該当する権限のチェックボックスを編集し、保存します。

    設定 - APIキー（権限範囲）

2.2.2. 再発行する

［］をクリック＞「有効期限」欄を変更し、再発行します。

設定 - APIキー（再発行）

2.2.3. 削除する

［］をクリックして削除します。

設定 - APIキー（削除）

改訂履歴表

改訂年月日 項番/項目 改訂内容

2022.04.22

新規作成

2022.06.24

2.2
3.1

画面UI変更 IPアドレス制限機能に対応

2023.03.31

1.3

「ログを出力する」を追加　APIログ出力に対応

2.2

段落構成を改善

2023.04.26

2.1-2.2

UI変更 「社外電話帳の読み取り」権限を追加

2023.06.30

2.1-2.2

UI変更 「社外電話帳の書き込み」権限を追加