如何在RingOut上使用带有RingOut的RingCentral API上的extensionId

时间:2018-03-28 19:21:50

标签: ringcentral ringout

我可以成功申请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

如果有人碰到这个或者可以指出任何潜在的陷阱,我会非常感谢一些指示。

1 个答案:

答案 0 :(得分:2)

从您的帖子和您收到的错误中,我假设您尝试使用未授权您的应用的extensionId执行RingOut。尝试这样做会导致您收到错误。以下是有关此内容的更多信息。

RingOut ExtensionId范围

RingOut API仅支持使用extensionId路径参数来授权用户扩展。因此,您需要调用的所有内容都是RingOut的以下端点:

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

如果要使用显式extensionId,则需要在以下端点中返回extensionId:

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

如果使用未授权使用访问令牌的路径extensionId参数调用端点,则会收到:

不匹配的ExtensionId错误

如果您尝试使用不是授权用户的路径extensionId值执行RingOut,您将收到以下正文的HTTP状态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授权代码或隐式授权通过登录弹出窗口对您的应用程序执行授权。
  • 或者,您可以询问他们的密码以执行OAuth 2.0密码授予授权。

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

增强请求

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

https://devcommunity.ringcentral.com/ringcentraldev