使用自定义API节点,可调用您在外部平台开发的API作为当前服务的中间逻辑功能。

前提条件

已完成业务服务的创建。详细内容请参见创建业务服务

节点配置

在业务逻辑编辑页面的节点中,选择对应功能节点配置业务流,该节点配置如下。

自定义API
配置项 说明
节点名称 设置节点名称。支持中文汉字、英文字母、数字和下划线(_),长度不超过30个字符。
请求方式 自定义API的请求方法支持POST和GET。
API地址 该API的调用地址。若涉及鉴权等逻辑需自己编写。
编码 编码方式支持UTF-8和GBK。
设置请求头 根据对应接口的Header要求设置API的请求头。
参数编写 根据所选API的请求参数,输入参数值。
注意 参数编写文本框不可置空。如果不设置参数,请在参数编写文本框中输入{}

如果参数值需配置为动态参数,使用其它上游节点传递的参数,可使用以下方法:

  • {{payload.参数名}}表示调用上一个节点输出参数。
  • {{query.参数名}}表示调用服务输入节点的输出参数。
  • {{node.nodeId.参数名}}表示调用指定某一节点的输出参数。

示例

{
   "productKey": "{{payload.productKey}}",  // 上一个节点的输出为:{productKey: '值'},取productKey的值
   "deviceName": "{{query.deviceName}}", // API输入节点的入参中定义了一个名称为deviceName的入参,取入参deviceName的值
   "pageNum": "{{node.node_399591c0.pageNum}}" // 节点node_399591c0的输出为{pageNum: 10},取pageNum的值
}

如果需要调用某参数的子集,可按如下示例方式调用。

使用{{payload.props.PM10.value}},表示上一个节点props对象中属性PM10的值。

使用{{query.deviceContext.deviceName}},表示第一个节点的输出内容中deviceContext对象的deviceName变量。

节点输出

将调用的API接口返回值作为节点输出。