Los ámbitos son nombres definidos por Genesys que categorizan los puntos finales en la API pública de Genesys Cloud. Cuando una aplicación está autorizada para tener un alcance específico, solo puede acceder a los puntos finales en la API que requieren ese alcance. Una aplicación no puede llamar a un punto final que requiera un alcance que no tiene.

Cada llamada a la API requiere un alcance, que puede ser de solo lectura o de lectura y escritura. Un alcance con el :solo lectura el sufijo es de solo lectura. Un ámbito sin sufijo permite operaciones de lectura y escritura.

Considere, por ejemplo, dos ámbitos que permiten el acceso a los usuarios de Genesys Cloud. Para otorgar acceso a una aplicación a los puntos finales relacionados con el usuario, un administrador asignaría uno de los siguientes ámbitos a la aplicación, en función de si el administrador desea que la aplicación pueda modificar los datos del usuario o no.

Nombre de alcance usuarios usuarios: solo lectura

Descripción

los usuarios El alcance permitirá que una aplicación lea y modifique datos sobre los usuarios de Genesys Cloud.

La aplicación puede utilizar los métodos GET, POST, PUT, PATCH y DELETE para llamar a los puntos finales de la API relacionados con el usuario.

los usuarios: solo lectura El alcance solo permite que una aplicación lea datos de usuario de Genesys Cloud.

Los ámbitos de solo lectura utilizan el método GET, excepto cuando se debe utilizar POST para enviar datos a la llamada API para búsquedas o datos analíticos.

En esos casos, la aplicación no modifica los datos, solo los recupera de un POST. El escenario general sigue siendo de solo lectura, incluso si se debe enviar información para obtener datos de respuesta.

Genesys Cloud admite muchos ámbitos adicionales, como ámbitos para grupos, correo de voz, arquitecto, estaciones, búsqueda, etc. La mayoría de los osciloscopios están disponibles con o sin el :solo lectura sufijo. Para obtener la lista completa de ámbitos, consulte Alcances en el Centro de desarrolladores de Genesys Cloud.

Nota: Una aplicación puede llamar a un punto final de API si tiene un alcance requerido por el punto final, solo cuando alguien que tenga permisos para acceder o modificar esos datos la esté utilizando. Los ámbitos por sí solos no autorizan el acceso. El usuario actual de la aplicación debe tener permisos que permitan la operación realizada por la llamada a la API. Se requieren tanto ámbitos como permisos.