Docs 菜单

Docs 主页Atlas App Services

第三方服务 [已弃用]

在此页面上

  • 简介
  • 概念
  • 服务客户端 [已弃用]
  • 服务操作 [已弃用]
  • 服务规则 [已弃用]
  • 传入 Webhook [已弃用]
  • 指南
  • 内置服务
  • 参考文档

重要

第三方服务和推送通知弃用

App Services 中的第三方服务和推送通知已弃用,转而创建在函数中使用外部依赖项的 HTTP 端点。

Webhook 已重命名为 HTTPS 端点,行为没有发生变化。您应该迁移现有的 Webhook。

现有服务将继续运行到 2024 年 11 月 1 日

由于第三方服务和推送通知现已弃用,因此,默认将其从 App Services 用户界面中删除。如果您需要管理现有的第三方服务或推送通知,可以执行以下操作以将配置重新添加到用户界面中:

  • 在左侧导航栏中的 Manage(管理)部分下面,单击 App Settings(应用设置)。

  • 启用 Temporarily Re-Enable 3rd Party Services(暂时重新启用第三方服务)旁边的切换开关,然后保存更改。

现代应用程序经常使用多个外部服务来处理复杂的使用案例,例如消息传递、分析和数据管理。您可以通过创建和配置服务接口,通过 Atlas App Services 连接到这些服务。

服务接口指定特定外部服务的连接详细信息,并使您能够使用自定义服务规则定义该服务的功能范围。为服务配置接口后,您可以实例化一个服务客户端,该客户端连接到该接口并将服务的操作公开为方法。您还可以创建传入的 Webhook ,使外部服务能够通过 HTTP 直接与您的应用程序通信。

注意

内置服务客户端

App Services 包括某些外部服务的客户端,例如TwilioAmazon Web Services 。您还可以使用HTTP Service为任何提供 REST API 的外部服务创建自定义接口。

服务客户端是连接到服务接口并支持调用与服务关联的操作的对象。您可以在函数(使用function context )和客户端应用程序代码中实例化服务客户端。

有关实例化和使用服务客户端的详细信息,请参阅调用服务操作。

服务操作是处理特定服务的特定使用案例的方法,例如使用 Twilio发送文本消息将对象放入Amazon Web Services S3 存储桶。操作封装了实现细节,例如请求身份验证和特定于每个服务的语义方法背后的 HTTP 方法。

当您调用服务操作时,App Services 会评估适用于该操作的每条服务规则并阻止执行,除非其中一条规则的计算结果为 true

重要

默认情况下,App Services 会阻止所有服务操作。 您必须先配置启用特定操作的服务规则,然后才能调用该操作。

服务规则是 App Services 计算以确定用户是否可以在服务中执行一个或多个 操作 的 表达式 。

例如,您可以创建一条Twilio规则,只允许用户通过特定电话号码发送短信;或者创建一条Amazon Web Services规则,禁止用户将对象放入未包含在已批准存储桶列表中的 S3 存储桶。

注意

表达式变量

表达式变量是可以包含在服务规则中的变量,用于表示有关应用程序和操作执行的动态信息。 您可以根据调用操作的经过身份验证的用户 ( %%user ) 及其提供的参数 ( %%args ) 配置服务规则。 您还可以创建复杂的规则来调用函数( %function ) 并根据函数的返回值进行评估。

传入的 Webhook 是源自外部服务的事件的自定义处理程序,例如当有人在GitHub 上打开新的拉取请求或向Twilio电话号码发送短信时。 通过配置服务 Webhook 开始使用传入的 Webhook。

传入的 Webhook 由两个主要组件组成:Webhook URL 和 Webhook 函数。

组件
说明
Webhook URL

唯一标识传入 Webhook 的 URL。 外部服务可以通过将与 Webhook 配置匹配的 HTTP 请求发送到 Webhook URL 来与 Webhook 进行交互。

要使用 Webhook,请向外部服务的 HTTP 请求处理程序提供 Webhook URL,该处理程序也称为传出 Webhook、回调 URL 或类似名称。

注意

如果传入的 Webhook 需要秘密查询参数,请确保将查询参数附加到 Webhook URL,然后再将其提供给外部服务。

Webhook Function
Webhook 函数是一种Realm 函数,它接受传入的 HTTP 请求,并将来自外部服务的数据作为参数,并可选择返回 HTTP 响应。
指南
说明
了解如何创建新的外部服务接口。
了解如何配置和执行传入的 Webhook 以处理外部服务中的事件。
了解如何安全地公开服务操作以在函数或客户端应用程序中使用。
了解如何从函数或客户端应用程序中调用服务操作。
主题
说明
包括服务配置参数、向 Twilio 添加 Webhook 的说明以及有关 Twilio 服务操作的其他信息。
包括有关 HTTP Service 和 Webhook 的其他信息。
包括服务配置参数、有关特定 Amazon Web Services 服务操作的其他信息以及连接到任何 Amazon Web Services 服务的通用说明。
包括服务配置参数、向 Github 添加 Webhook 的说明,以及验证来自 Github 的传入请求的指导。
主题
说明
描述如何验证传入请求、解析请求有效负载以及在服务 Webhook 函数中发送响应。
← 推送通知 [已弃用]