外部服务

如果您希望区块链上的各种事件能自动触发您的自有业务应用或者第三方服务时,您可以将区块链事件和外部HTTP服务做映射配置。当区块链服务监听到链上事件时,会自动触发该HTTP服务。

配置外部HTTP服务触发器

说明: 配置外部HTTP服务触发器,需要您先安装云服务集成功能,详情请参考安装云服务集成

  1. 我的组织 中找到目标组织,单击右侧的 云服务集成
  2. 将云服务集成页面的标签切换到 外部 HTTP 服务
  3. 单击 添加配置 ,在侧边弹框中依次填写以下配置信息:
    • 名称:触发器的名称,便于识别。
    • 通道/网络:触发器需要监听并推送事件的Fabric通道。
    • 事件类型:选择推送哪种类型的事件到外部服务,类型描述请参考文档订阅事件
    • URL:外部服务的 http/https 地址。
    • 方法:请求外部服务地址的方法,支持 GET/POST。
    • 认证方式:
      • 无:不需要认证。
      • basic:基于用户和密码的 Basic Auth 认证。
      • bearer:基于 http bearer token 的认证方式。
    • 失败阈值:高级选项,触发器操作失败的次数超过该值后,触发器进入失败状态并停止推送。-1 表示失败次数不限,触发器不会进入失败状态。
    • 过滤器:高级选项,可选,请参考文档使用过滤器配置服务
  4. 单击添加,成功后列表会显示刚才创建的触发器。外部服务配置列表

    注意:

    • 当触发器推送区块链事件到集成的服务时,服务处理错误或参数配置错误会使触发器状态变为异常,鼠标悬停即可查看错误信息。
    • 触发器对应的服务返回异常时,触发器会自动重试,多次重试均失败后,会丢弃该事件,算一次失败。如果累计失败次数没有超过失败阈值,则继续推送其它事件。如果超过失败阈值,触发器进入失败状态并停止推送。用户可根据错误信息对触发器或相关服务进行修复后,再重新启用,启用后失败次数清零。
    • 块高字段表示当前触发器已处理到哪一个区块,也反应了事件处理进度。
  5. 创建成功后,您可以对触发器进行以下操作:

    • 删除:删除该触发器。
    • 禁用:停止推送事件到该触发器对应的服务。
    • 启用:重新开始推送事件到该触发器对应的服务。启用后,将从当前最新区块的事件开始推送,停止期间的事件会被丢弃。