RingCentral 会议 API 错误 - "user needs to have [Meetings] permission for requested resource"

Question

我已经创建了一个用于阅读会议列表的应用程序，尽管我已经为 Meetings.

设置了权限，但还是出现了以下错误

API:

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting

错误：

{
  "errorCode":"CMN-408",
  "message":"In order to call this API endpoint, user needs to have [Meetings] permission for requested resource.",
  "errors":[
    {
      "errorCode":"CMN-408",
      "message":"In order to call this API endpoint, user needs to have [Meetings] permission for requested resource.",
      "permissionName":"Meetings"
    }
  ],
  "permissionName":"Meetings"
}

参考：https://developer.ringcentral.com/api-docs/latest/index.html#!#RefMeetingsList.html

Answer 1

用户与应用权限

当应用请求通过 REST API 访问会议等用户资源时，它使用与应用和授权应用的用户相关联的访问令牌。 API 可能需要应用和用户许可。当权限returns错误user needs to have如下图，说明需要用户权限

In order to call this API endpoint, user needs to have [Meetings] permission \
for requested resource.

解决这个问题需要三个组成部分：

检查用户权限
查找权限的显示名称
为用户添加权限

1.检查用户权限

括号内的文字是permissionId。您可以通过调用权限检查API来检查您的用户是否具有此权限，如下所示：

GET /restapi/v1.0/account/~/extension/~/authz-profile/check?permissionId=Meetings

您将收到如下回复。 successful 属性将显示 true 或 false 取决于用户是否具有特定权限。如果您看到此错误，应将 successful 设置为 false。

{
  "uri":"https://platform.ringcentral.com/restapi/v1.0/account/11111111/extension/22222222/authz-profile/check?permissionId=Meetings&targetExtensionId=11111111",
  "successful":true,
  "details":{
    "permission":{
      "uri":"https://platform.ringcentral.com/restapi/v1.0/dictionary/permission/Meetings",
      "id":"Meetings",
      "assignable":true,
      "readOnly":false,
      "siteCompatible":"Independent"
    },
    "effectiveRole":{
      "uri":"https://platform.ringcentral.com/restapi/v1.0/dictionary/user-role/3",
      "id":"3"
    },
    "scopes":[
      "Self"
    ]
  }
}

参考：https://developer.ringcentral.com/api-docs/latest/index.html#!#RefCheckUserPermissions

2。查找权限的显示名称

要将此权限添加到用户，需要获取将用于通过在线帐户门户添加此权限的权限的显示名称（https://service.ringcentral.com 用于生产）。

您可以通过调用权限的字典端点来获取此信息，其中 permissionId 是 Meetings，如下所示。

GET /restapi/v1.0/dictionary/permission/{permissionId}
GET /restapi/v1.0/dictionary/permission/Meetings

响应将有一个 displayName 属性指示“会议应用程序访问”是在线帐户门户中的 UI 权限。

或者，您可以进行 API 调用以获取权限列表并在此处查找 permissionId 即 Meetings。在下面的响应摘录中，"displayName":"Meetings App Access" 设置为 "id":"Meetings"。

GET /restapi/v1.0/dictionary/permission

您将收到如下回复。为简洁起见，我删除了所有其他权限：

{
  "uri":"https://platform.ringcentral.com/restapi/v1.0/dictionary/permission?page=1&perPage=100",
  "records":[
    {
      "uri":"https://platform.ringcentral.com/restapi/v1.0/dictionary/permission/Meetings",
      "id":"Meetings",
      "displayName":"Meetings App Access",
      "assignable":true,
      "readOnly":false,
      "siteCompatible":"Independent",
      "category":{
        "uri":"https://platform.ringcentral.com/restapi/v1.0/dictionary/permission-category/Meetings",
        "id":"Meetings"
      },
      "includedPermissions":[

      ]
    }
  ]
}

参考：https://developer.ringcentral.com/api-docs/latest/index.html#!#RefDictionaryPermissionList.html

3。为用户添加权限

现在转到 RingCentral 在线帐户门户并确保用户在其角色中拥有此权限。

在线帐户门户位于：

生产环境：https://service.ringcentral.com
沙盒环境：https://service.devtest.ringcentral.com

登录后，使用以下说明查找用户角色并确保该角色具有“Meetings App Access”权限：

知识库：How do I set up User Roles and Permissions? How do I assign a specific role to Users?

在 UI 中将如下所示：

RingCentral 会议 API 错误 - "user needs to have [Meetings] permission for requested resource"

RingCentral Meetings API Error - "user needs to have [Meetings] permission for requested resource"

permissions

user-permissions

ringcentral