反馈 编辑

删除呼叫

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

删除或挂断活动呼叫。 对于组呼叫，这只会删除你的通话记录，基础组呼叫将继续。

权限

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） 不支持。
委派（个人 Microsoft 帐户） 不支持。
应用程序 Calls.Initiate.All、Calls.AccessMedia.All

注意： 创建调用时检查权限;调用此 API 时，不会进行其他权限检查。 Calls.AccessMedia.All 仅对于使用应用托管媒体的呼叫是必需的。

HTTP 请求

DELETE /app/calls/{id}
DELETE /communications/calls/{id}

注意：/app 路径已弃用。 今后将使用 /communications 路径。

请求标头

名称 说明
Authorization Bearer {token}。必需。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法返回 204 No Content 响应代码。它不在响应正文中返回任何内容。

示例

请求

下面为请求示例。

DELETE https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896

响应

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 204 No Content

通知 - 终止

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "updated",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminating"
      }
    }
  ]
}

Notification - 已终止

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "deleted",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminated",
        "resultInfo": {
          "@odata.type": "#microsoft.graph.resultInfo",
          "code": "200",
          "subcode": "5001",
          "message": "The conversation has ended."
        }
      }
    }
  ]
}

呼叫结束原因代码

这些是呼叫终止时通过通知收到的一些常见错误代码。

代码 子代码 终止原因
200 4097 呼叫由呼叫中的另一个参与者结束。
200 4521 对等呼叫中其他参与者结束的呼叫。
200 5000 由另一个参与者从对话中删除。
200 5001 对话已结束。
200 5002 对话已结束，因为所有其他参与者已离开呼叫。
200 5003 对话已结束。
200 5007 对话已作为组呼叫发起人离开对话结束。
200 5010 对话已结束，因为只有一个参与者留在对话中。
200 5012 对话已结束，因为传入名单中没有参与者。
200 5013 对话已结束，因为其他人都未加入组呼叫。
200 5014 对话已结束，因为我们无法确定组呼叫的潜在主机。
200 5020 对话已结束，因为传入名单中没有非隐藏参与者。
200 5030 对话已结束，因为聊天室持续时间已过。
200 5300 参与者已被另一个参与者从对话中删除。
200 5855 大厅不活动超时后，在大厅中等待的参与者已从对话中删除。
200 7000 对话已由机器人结束。
200 7015 呼叫在转接成功完成时结束。
200 10550 对话已由机器人结束。
200 18503 对等呼叫中的另一个参与者离开对话。
200 540000/560000 呼叫由 PSTN 用户结束。
408 8537 保持活动状态超时，清理非活动呼叫。
408 1106 在分配的时间内未收到呼叫接受的确认。
408 10057 由于被叫方终结点没有信号，呼叫被叫方被叫出。
410 301005 媒体连接失败。
480 10037 未找到被叫方终结点。
480 10076 无法联系被叫方。
480 10134 由于无法路由呼叫，呼叫被拒绝。
480 10199 用户已禁用作为私人呼叫拒绝的呼叫。
500 1005 服务器遇到自动程序媒体连接错误。 请检查 Bot 和 Microsoft 之间的媒体连接。