ステップ: REST API を使用したカスタム アプリの構築
Peakon の
管理者
アクセス権Peakon が提供する外部 REST API を使用して、社員のプロビジョニング用のカスタム アプリケーションとインテグレーションを作成し、リソースにアクセスできます (ない場合は Peakon ダッシュボードでのみ公開)。
API ドキュメントでリソースを確認します。アクセス: https://developer.peakon.com/
- Peakon テナントで、に移動します。
- アプリケーションに名前を付け、権限を作成します。Peakon では、アプリケーションに対して最小限の権限を付与することをお勧めします。
- 生成されたアクセス トークンをコピーします。トークンは、アプリケーションが Peakon のリモート リソースにアクセスするために使用する唯一の認証情報であり、1 回だけ表示されます。Peakon では安全に保管し、他のアプリケーションと共有しないことをお勧めします。
- POST /v1/auth/ application エンドポイントを呼び出します。生成されたアクセス トークンを POST /v1/auth/applicロード エンドポイントのリクエスト本文で指定します。成功した認証リクエストに対して、このエンドポイントは JSON Web トークンを返します。詳細については、Peakon API Reference の Authenticate applicationEndpoint を参照してください。
- 後続の API リクエストの "認証" ヘッダーに JWT トークンを埋め込みます。認証トークンと承認トークンが分離されているため、アプリケーション開発者または企業管理者のみが認証トークンにアクセスできるデプロイが可能になります。アプリケーション ユーザーと認証トークンを割り当てて共有します。
- 新しいアプリケーションから適切な Peakon API リクエストを送信してください。追加のパラメータを指定してリクエストを送信できます。例: データを除外するか、時間間隔を指定します。API エンドポイントとそのパラメータのリストについては、Peakon API リファレンスを参照してください。