配置 Webhook 侦听器
配置 webhook 侦听器（也称为 HTTP 推送 API），使微应用能够向最终用户提供接近实时的数据。配置 webhook 可以让你的应用以比从微应用平台端同步更快的速度向其他应用程序传递数据。MA 服务器可以处理的 webhook 请求正文的最大大小为 64 kb。
添加 webhook 侦听器需要您熟悉目标应用程序记录系统，并设置必要的工具和管理权限，以便在这些位置配置 Webhook。
在通过 数据加载 设置集成之后配置你的 webhook，然后按照以下步骤操作：
-
单击 HTTP 集成屏幕左侧栏上的 Webhook 侦听器 ：
- 输入你想要的 webhook 名称。
- 选择 复制 以复制 webhook URL，以便在目标记录系统管理界面中使用。
授权方法
配置授权方法时，您可以选择 令牌 授权方法或 无 。要配置 令牌 方法，请执行以下步骤：
- 在 授权 方法菜单中选择 令牌 。
- 选择 生成令牌 ，然后选择 复制 以将令牌添加到剪贴板，以便在目标记录系统管理界面中使用。
-
从中选择 读取令牌 以进行选择：
- 根据您选择的读取方法定义 名称 或 前缀 。
令牌现已设置。
请求方法
配置 Webhook 侦听器时，请使用以下定义构建调用：
-
PUT 用于更新现有资源。
-
POST 会创建新的从属资源，因此 POST 方法用于在资源集合中创建新的资源。
PUT 和 POST 都使用根表的主键信息从子表中删除数据。然后它会替换现有记录或插入一条新记录。
-
DELETE 用于删除资源。
DELETE 有两个端点：
-
{serviceUuid}/{webhookListenerUuid}/{recordId} 其中 recordId 是要删除的根表中记录的主键的值。相应地删除子表中的记录。
-
{serviceUuid}/{webhookListenerUuid}/?id1=1&id2=1 其中 id1 和 id2 表示要删除的根表中记录的复合主键的值。相应地删除子表中的记录。
-
PATCH 请求用于对资源进行部分更新。
定义数据结构
您可以使用在数据 加载配置期间获取数据结构时描述的类似方法来定义数据 结构。有关更多信息 ，请参阅配置集成。
要定义你的 webhook 数据结构，请按照下列步骤操作：
- 设置所需的数据保留期限。所有早于此日期的条目都将被删除。每个保存的条目都包含其修改日期和时间。那就是
lastModified。此日期和时间用于决定要删除哪些条目。
-
选择 “ 生成表”。
此时将打开 “ 生成表 ” 屏幕。
将来自目标应用程序记录系统的 JSON 示例请求粘贴到此处。
- 设置已创建表的基本名称。
- （可选）如有必要，设置 根路径 。
- 选择 “ 生成”。
在完成此过程以及目标应用程序记录系统管理中完成的配置措施之后，选择 添加。
你的 webhook 现在已配置完毕。
脚本支持
Webhook 侦听器支持在 HTTP 集成 脚本功能中配置的自定义脚本。
您可以在 Citrix Developer 门户网站上找到有关开发和实施自己的脚本的更多信息。
显示 Webhook 日志
使用 Webhook 日志 查看来自所有 webhook 端点的请求和错误的历史记录。您可以按 webhook 名称和状态进行过滤，例如成功、错误或全部。为了提高性能，在 webhook 日志屏幕中仅保留最后 10 个 webhook 日志条目以供查看。
- 在 “管理微应用” 页面中，选择要查看其集成日志的集成旁边的菜单。
- 选择 Webhook 日志。
- 查看条目，然后从菜单中选择以根据需要进行筛选。
本内容的正式版本为英文版。部分 Citrix 文档内容采用了机器翻译，仅供您参考。Citrix 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Citrix 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Citrix 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Citrix 不承担任何责任。
DIESER DIENST KANN ÜBERSETZUNGEN ENTHALTEN, DIE VON GOOGLE BEREITGESTELLT WERDEN. GOOGLE LEHNT JEDE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GEWÄHRLEISTUNG IN BEZUG AUF DIE ÜBERSETZUNGEN AB, EINSCHLIESSLICH JEGLICHER GEWÄHRLEISTUNG DER GENAUIGKEIT, ZUVERLÄSSIGKEIT UND JEGLICHER STILLSCHWEIGENDEN GEWÄHRLEISTUNG DER MARKTGÄNGIGKEIT, DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG VON RECHTEN DRITTER.
CE SERVICE PEUT CONTENIR DES TRADUCTIONS FOURNIES PAR GOOGLE. GOOGLE EXCLUT TOUTE GARANTIE RELATIVE AUX TRADUCTIONS, EXPRESSE OU IMPLICITE, Y COMPRIS TOUTE GARANTIE D'EXACTITUDE, DE FIABILITÉ ET TOUTE GARANTIE IMPLICITE DE QUALITÉ MARCHANDE, D'ADÉQUATION À UN USAGE PARTICULIER ET D'ABSENCE DE CONTREFAÇON.
ESTE SERVICIO PUEDE CONTENER TRADUCCIONES CON TECNOLOGÍA DE GOOGLE. GOOGLE RENUNCIA A TODAS LAS GARANTÍAS RELACIONADAS CON LAS TRADUCCIONES, TANTO IMPLÍCITAS COMO EXPLÍCITAS, INCLUIDAS LAS GARANTÍAS DE EXACTITUD, FIABILIDAD Y OTRAS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDAD, IDONEIDAD PARA UN FIN EN PARTICULAR Y AUSENCIA DE INFRACCIÓN DE DERECHOS.
本服务可能包含由 Google 提供技术支持的翻译。Google 对这些翻译内容不做任何明示或暗示的保证，包括对准确性、可靠性的任何保证以及对适销性、特定用途的适用性和非侵权性的任何暗示保证。
このサービスには、Google が提供する翻訳が含まれている可能性があります。Google は翻訳について、明示的か黙示的かを問わず、精度と信頼性に関するあらゆる保証、および商品性、特定目的への適合性、第三者の権利を侵害しないことに関するあらゆる黙示的保証を含め、一切保証しません。
ESTE SERVIÇO PODE CONTER TRADUÇÕES FORNECIDAS PELO GOOGLE. O GOOGLE SE EXIME DE TODAS AS GARANTIAS RELACIONADAS COM AS TRADUÇÕES, EXPRESSAS OU IMPLÍCITAS, INCLUINDO QUALQUER GARANTIA DE PRECISÃO, CONFIABILIDADE E QUALQUER GARANTIA IMPLÍCITA DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO E NÃO INFRAÇÃO.