第三方服务 [已弃用]
重要
第三方服务和推送通知弃用
App Services 中的第三方服务和推送通知已弃用,转而创建在函数中使用外部依赖项的 HTTP 端点。
Webhook 已重命名为 HTTPS 端点,行为没有发生变化。您应该迁移现有的 Webhook。
现有服务将继续运行到 9 月30 ,2025 。
由于第三方服务和推送通知现已弃用,因此,默认将其从 App Services 用户界面中删除。如果您需要管理现有的第三方服务或推送通知,可以执行以下操作以将配置重新添加到用户界面中:
在左侧导航栏中的 Manage(管理)部分下面,单击 App Settings(应用设置)。
启用 Temporarily Re-Enable 3rd Party Services(暂时重新启用第三方服务)旁边的切换开关,然后保存更改。
简介
现代应用程序经常使用多个外部服务来处理复杂的使用案例,例如消息传递、分析和数据管理。您可以通过创建和配置服务接口,通过 Atlas App Services 连接到这些服务。
服务接口指定特定外部服务的连接详细信息,启用您能够使用自定义服务规则定义该服务的功能范围。 为服务配置接口后,您可以实例化一个服务客户端,该客户端连接到该接口并将服务的操作公开为方法。 您还可以创建传入的 Webhook ,启用外部服务能够通过HTTP直接与您的应用程序通信。
注意
内置服务客户端
App Services 包括某些外部服务的客户端,例如Twilio和Amazon Web Services 。您还可以使用HTTP Service为任何提供 REST API 的外部服务创建自定义接口。
概念
服务客户端 [已弃用]
服务客户端是连接到服务接口并支持调用与服务关联的操作的对象。 您可以在函数(使用函数上下文 )和客户端应用程序代码中实例化服务客户端。
有关实例化和使用服务客户端的详细信息,请参阅调用服务操作。
服务操作 [已弃用]
服务操作是处理特定服务的特定使用案例的方法,例如使用 Twilio发送文本消息或将对象放入Amazon Web Services S3 存储桶。操作封装了实现细节,例如请求身份验证和特定于每个服务的语义方法背后的 HTTP 方法。
当您调用服务动作时, App Services会评估适用于该动作的每条服务规则并阻止执行,除非其中一条规则的计算结果为 true
。
重要
默认情况下,App Services 会阻止所有服务操作。 您必须先配置启用特定操作的服务规则,然后才能调用该操作。
服务规则 [已弃用]
服务规则是App Services计算以确定用户是否可以在服务中执行一个或多个 操作 的 表达式 。
例如,您可以创建一条Twilio规则,只允许用户通过特定电话号码发送短信;或者创建一条Amazon Web Services规则,禁止用户将对象放入未包含在已批准存储桶列表中的 S3 存储桶。
传入 Webhook [已弃用]
传入的 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 函数中发送响应。 |