Les portées sont des noms définis par Genesys qui catégorisent les points de terminaison dans l’API publique Genesys Cloud. Lorsqu’une application est autorisée à posséder une étendue spécifique, elle ne peut accéder aux points de terminaison de l’API nécessitant cette étendue. Un application ne peut pas appeler un point de terminaison nécessitant une étendue qu’il n’a pas.

Chaque appel d’API nécessite une étendue, qui peut être en lecture seule ou en lecture-écriture. Une portée avec le :lecture seulement le suffixe est en lecture seule. Une étendue sans suffixe autorise les opérations de lecture-écriture.

Prenons par exemple deux champs d’application qui permettent l’accès aux utilisateurs Genesys Cloud. Pour accorder à une application l’accès aux points de terminaison liés à utilisateur, un administrateur attribuerait à l’application l’une des portées suivantes, en fonction du fait que l’administrateur souhaite ou non que l’application puisse modifier les données .

Nom de la portée utilisateurs utilisateurs:lecture seule

Description

le utilisateurs scope permettra à une application de lire et de modifier les données sur les utilisateurs de Genesys Cloud.

L’application peut utiliser les méthodes GET, POST, PUT, PATCH et DELETE pour appeler les points de terminaison de l’API utilisateur.

leutilisateurs : lecture seule scope permet uniquement à une application de lire les données utilisateur de Genesys Cloud.

Les portées en lecture seule utilisent la méthode GET, sauf lorsque POST doit être utilisé pour soumettre des données à l’appel API pour des données ou des recherches analytique.

Dans ces cas, l’application ne modifie pas les données, mais récupère les données d’un POST. Le scénario global reste en lecture seule, même si des informations doivent être envoyées pour obtenir les données réponse.

Genesys Cloud prend en charge de nombreuses étendues supplémentaires, telles que les étendues pour les groupes, la messagerie vocale, l’architecte, les stations, la recherche, etc. La plupart des portées sont disponibles avec ou sans le :lecture seulement suffixe. Pour la liste complète des étendues, voir Portées dans le Centre de développement Genesys Cloud.

Remarque :  Une application peut appeler une API point de terminaison si elle a une étendue requise par point de terminaison, uniquement si elle est utilisée par une personne disposant des autorisations lui permettant d’accéder ou de modifier ces données. Les étendues seules n’autorisent pas l’accès. L’actuelle utilisateurYYZZY de l’application doit disposer d’autorisations permettant l’opération effectuée par l’appel de l’API. Les étendues et les autorisations sont requises.