roles - RingCentral 转发号码 API `ReadUserForwardingFlipNumbers` 权限

Question

当我尝试 RingCentral Get Forwarding Number API 时：

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number

我收到此错误：

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

我在在线帐户门户 ( https://service.ringcentral.com ) 中看不到此权限，即使在超级管理员角色下也是如此。如何解决此问题并访问此 API？

Answer 1

ReadUserForwardingFlipNumbers是在线帐户门户中配置的用户权限。用户分配的角色需要在 Online Account Portal 中具有以下相应权限：

User Settings>Messages & Notifications

您可以在以下在线账户门户中看到：

Users> Roles>{Role Name}

例如：

您可以通过调用以下端点来验证您的用户是否具有此权限：

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile

这将返回一个 JSON 对象，该对象具有一个permissions具有权限数组的属性。此权限如下所示：

{
    "permission": {
        "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadUserForwardingFlipNumbers",
        "id": "ReadUserForwardingFlipNumbers",
        "assignable": false,
        "readOnly": false,
        "siteCompatible": "Independent"
    },
    "effectiveRole": {
        "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/user-role/3",
        "id": "3"
    },
    "scopes": [
        "Self"
    ]
},