スコープの概要


近日公開予定の機能

スコープは、 PureCloudパブリックAPIでエンドポイントを分類するGenesys定義の名前です。アプリが特定のスコープを持つことを承認されると、そのスコープを必要とするAPI内のエンドポイントにのみアクセスできます。アプリケーションは、持たないスコープを必要とするエンドポイント呼び出すことはできません。

すべてのAPI呼び出しには、読み取り専用または読み取り/書き込みのスコープが必要です。スコープ :読み取り専用 接尾辞は読み取り専用です。接尾辞のないスコープは、読み取り/書き込み操作を許可します。

たとえば、 PureCloudユーザーへのアクセスを許可する2つのスコープを検討してください。するアプリのアクセスを許可するにはユーザー関連のエンドポイントを、管理者は、管理者がアプリを変更できるようにしたいかどうかに基づいて、アプリに次のスコープのいずれかを割り当てますユーザーデータかどうかを。

スコープ名 users users:readonly

説明

ユーザー スコープにより、アプリはPureCloudユーザーに関するデータを読み取り、変更できます。

アプリは、GET、POST、PUTを使用PATCH、および呼び出すためのメソッドを削除することができユーザー -relatd APIエンドポイントを。

の users:readonly スコープは唯一のアプリケーションが読み込むことができますユーザーからデータをPureCloud 。

読み取り専用スコープはGETメソッドを使用しますが、 分析データまたは検索のためにAPI呼び出しにデータを送信するためにPOSTを使用する必要がある場合を除きます。

このような場合、アプリはデータを変更せず、POSTからデータを取得するだけです。応答データを取得するために情報を送信する必要がある場合でも、全体的なシナリオは依然として読み取り専用です。

PureCloudは、グループ、ボイスメール、アーキテクト、ステーション、 検索などのスコープなど、多くの追加のスコープをサポートしています。ほとんどのスコープは、 :読み取り専用 サフィックス。スコープの完全なリストについては、 スコープ の中に PureCloud 開発者センター

注意: アプリがAPIを呼び出すことができエンドポイントそれがで必要な範囲を持っている場合はエンドポイント 、それがアクセスしたり、そのデータを変更する権限を持っている人によって使用されている場合のみです。スコープだけではアクセスを許可しません。アプリの現在のユーザー API呼び出しの動作を許可する権限を持っている必要があります。スコープとアクセス許可の両方が必要です。