接口调用图元

图元展示

参数介绍

  • 节点名称:标识节点名称。
  • 描述:节点的详细说明信息。
  • 接口类型:请选择需要调用的接口类型。取值范围:内置接口,自定义接口。内置接口现两个:
    • 记录问答:用于记录问卷标识、问题标题、用户回答意图、用户原始答等信息;
    • 获取APIFabric token:用于获取APIFabric token的接口,机器人调用接口成功后token会记入缓存,有效期内会直接从缓存中获取。修改aksk后,原有的缓存不会被清理,在缓存有效期内调用APIFabric token接口会失败。如果调用APIFabric token接口需要立即生效,可以将本流程绑定到新的机器人。
  • 调用接口:选择您在资源管理 > 业务接口中添加的接口。
  • 变量赋值:即变量名和变量值。由于接口返回的出参只能在当前节点有效,如果您需要在后续流程中应用该值,可在此处定义变量,将接口出参的值赋给它。
  • 条件分支:即条件名和条件表达式。定义当前图元的出口有哪些分支,例如可以根据某个出参的取值来设置分支,每个分支可以指定不同的后续流程。
  • 方法调用:如果业务需要对数据处理,比如截取、获取长度、转换、判断等,可以使用内置函数

分支条件介绍

表1 分支条件

名称

含义

使用方法

SYSERROR_INNER

odfs内部错误

ODFS内部发生其他未知错误时会触发该分支条件,不选择则进入异常流程。

SYSERROR_INTERFACE

接口调用失败

接口调用异常时会触发该分支条件,不选择则进入异常流程。

如何使用图元

单击图元,或使用鼠标将图元拖拽到画布上,然后选择需要调用的接口,被调用的接口需要事先在资源管理 > 业务接口中维护,或在弹窗的选择接口弹窗中点击添加。如果使用该图元赋值,可无需选择接口,直接添加缓存变量名,将其赋值。此时需要事先维护全局变量。

典型使用场景

被调用的接口返回字段包含returnCode时,如果returnCode值为"0"时表示成功,其余值为失败。

相关文档