接口调用图元
图元展示
参数介绍
- 节点名称:标识节点名称。
- 描述:节点的详细说明信息。
- 接口类型:请选择需要调用的接口类型。取值范围:内置接口,自定义接口。内置接口现两个:
- 记录问答:用于记录问卷标识、问题标题、用户回答意图、用户原始答等信息;
- 获取APIFabric token:用于获取APIFabric token的接口,机器人调用接口成功后token会记入缓存,有效期内会直接从缓存中获取。修改aksk后,原有的缓存不会被清理,在缓存有效期内调用APIFabric token接口会失败。如果调用APIFabric token接口需要立即生效,可以将本流程绑定到新的机器人。
- 调用接口:选择您在 中添加的接口。
- 变量赋值:即变量名和变量值。由于接口返回的出参只能在当前节点有效,如果您需要在后续流程中应用该值,可在此处定义变量,将接口出参的值赋给它。
- 条件分支:即条件名和条件表达式。定义当前图元的出口有哪些分支,例如可以根据某个出参的取值来设置分支,每个分支可以指定不同的后续流程。
- 方法调用:如果业务需要对数据处理,比如截取、获取长度、转换、判断等,可以使用内置函数。
分支条件介绍
名称 |
含义 |
使用方法 |
---|---|---|
SYSERROR_INNER |
odfs内部错误 |
ODFS内部发生其他未知错误时会触发该分支条件,不选择则进入异常流程。 |
SYSERROR_INTERFACE |
接口调用失败 |
接口调用异常时会触发该分支条件,不选择则进入异常流程。 |
如何使用图元
单击图元,或使用鼠标将图元拖拽到画布上,然后选择需要调用的接口,被调用的接口需要事先在
中维护,或在弹窗的选择接口弹窗中点击添加。如果使用该图元赋值,可无需选择接口,直接添加缓存变量名,将其赋值。此时需要事先维护全局变量。典型使用场景
被调用的接口返回字段包含returnCode时,如果returnCode值为"0"时表示成功,其余值为失败。