범위 소개

범위는 Genesys Cloud Public API에서 엔드포인트를 분류하는 Genesys 정의 이름입니다. 앱이 특정 범위를 갖도록 승인되면 해당 범위가 필요한 API의 끝점에만 액세스할 수 있습니다. 애플리케이션은 갖고 있지 않은 범위가 필요한 엔드포인트를 호출할 수 없습니다.

모든 API 호출에는 읽기 전용 또는 읽기-쓰기가 가능한 범위가 필요합니다. 스코프 :읽기 전용 접미사는 읽기 전용입니다. 접미사가 없는 범위는 읽기-쓰기 작업을 허용합니다.

예를 들어 Genesys Cloud 사용자에 대한 액세스를 허용하는 두 가지 범위를 고려하십시오. 앱에 사용자 관련 엔드포인트에 대한 액세스 권한을 부여하기 위해 관리자는 앱이 사용자 데이터를 수정할 수 있기를 원하는지 여부에 따라 다음 범위 중 하나를 앱에 할당합니다.

범위 이름 users users:readonly

설명

NS 사용자 범위를 사용하면 앱이 Genesys Cloud 사용자에 대한 데이터를 읽고 수정할 수 있습니다.

앱은 GET, POST, PUT, PATCH 및 DELETE 메서드를 사용하여 사용자 관련 API 끝점을 호출할 수 있습니다.

NS 사용자:읽기 전용 범위를 사용하면 앱이 Genesys Cloud에서 사용자 데이터를 읽을 수만 있습니다.

읽기 전용 범위는 분석 데이터 또는 검색을 위해 API 호출에 데이터를 제출하는 데 POST를 사용해야 하는 경우를 제외하고 GET 메서드를 사용합니다.

이러한 경우 앱은 데이터를 수정하지 않고 POST에서 데이터를 다시 가져옵니다. 응답 데이터를 얻기 위해 정보를 보내야 하는 경우에도 전체 시나리오는 여전히 읽기 전용입니다.

Genesys Cloud는 그룹, 음성 메일, 설계자, 스테이션, 검색 등의 범위와 같은 많은 추가 범위를 지원합니다. 대부분의 범위는 포함 또는 포함하지 않고 사용할 수 있습니다. :읽기 전용 접미사. 범위의 전체 목록은 다음을 참조하세요. 범위 에서 Genesys Cloud 개발자 센터.

참고: 앱은 엔드포인트에 필요한 범위가 있는 경우 API 엔드포인트를 호출할 수 있습니다. 단, 해당 데이터에 액세스하거나 수정할 수 있는 권한이 있는 사람이 앱을 사용하는 경우에만 가능합니다. 범위만으로는 액세스를 승인하지 않습니다. 앱의 현재 사용자는 API 호출에 의해 수행되는 작업을 허용하는 권한이 있어야 합니다. 범위와 권한이 모두 필요합니다.