如何在RingOut中使用RingCentral上的extensionId API

Question

I can RingOut成功请求：

https://platform.ringcentral.com/restapi/v1.0/account/~/extension/~/ring-out

但是当我想要添加扩展id时，我得到了一个CMN-102错误(Resource for parameter [extensionId] is not found)参见下面的请求示例：

https://platform.ringcentral.com/restapi/v1.0/account/~/extension/279580017/ring-out

我非常确定我有正确的id，因为我成功地从下面的请求中获取了extensionId：

https://platform.ringcentral.com/restapi/v1.0/account/~/extension

如果有人遇到这种情况，或者可以指出任何潜在的陷阱，我将非常感谢一些提示。

Answer 1

从你的帖子和你收到的错误来看，我假设你正在尝试使用一个没有授权你的应用程序的extensionId来执行RingOut。尝试这样做将导致您收到的错误。这里有更多关于这方面的信息。

RingOut ExtensionId Scope

RingOut接口仅支持对授权用户扩展使用extensionId path参数。因此，您所需要调用的就是RingOut的以下端点：

POST /restapi/v1.0/account/~/extension/~/ring-out

如果要使用显式extensionId，它需要是在以下端点中返回的extensionId：

GET /restapi/v1.0/account/~/extension/~

如果您使用未授权正在使用的访问令牌的path extensionId参数调用端点，则您将收到：

不匹配的ExtensionId错误

如果您尝试使用非授权用户的路径HTTP值执行RingOut，您将收到extensionId状态404错误，并显示以下正文：

HTTP/1.1 404 Not Found

{
  "errorCode": "CMN-102",
  "message": "Resource for parameter [extensionId] is not found",
  "errors": [
    {
      "errorCode": "CMN-102",
      "message": "Resource for parameter [extensionId] is not found",
      "parameterName": "extensionId"
    }
  ],
  "parameterName": "extensionId"
}

如何为多个用户执行RingOut

要在此时为多个用户执行RingOut，您需要执行以下任一操作：

• 每个用户都必须使用您的应用程序执行授权，通过OAuth 2.0授权码或隐式grant.
• alternately，的登录弹出窗口您可以要求他们提供其密码以执行OAuth 2.0 password grant authorization.

我们的GitHub账户上提供了许多OAuth 2.0演示应用程序：

• https://ringcentral.github.io/tutorials/
• https://github.com/ringcentral/ringcentral-demos-oauth

增强请求

如果您希望在没有活动会话的情况下向任何用户提供RingOut功能，请让我们知道，我们可以将其视为功能增强。最好的方法是使用您的RingCentral帐户登录我们的社区，并在此处发布请求：

https://devcommunity.ringcentral.com/ringcentraldev