HTTP API方式

概述

开发过程中：主要用于描述集成流和集成接口之间的绑定关系，如下图所示。集成流和集成接口之间的关系，请参见集成流与集成接口的关系说明。

运行时：主要负责路由和入参校验，将校验通过的请求转换成相应的消息格式并向后续节点传递。

路由和入参校验

引擎在运行时会根据请求的HTTP Request Method和HTTP Requst URL进行匹配，查找对应的元数据进行动态处理。

同时，引擎还会根据集成接口定义的入参，对HTTP请求内容进行校验，只有满足条件的请求才能响应执行。如果校验失败，会直接返回错误。

• 一次请求中同时出现多个校验失败错误时，只会选择报出其中一个错误信息。

• 错误码信息如下：

示例如下：

节点输出消息

输出消息的Payload为HttpRequest类型，关于HttpRequest类型说明，请参见HttpRequest。

本文以获取调用集成接口的入参内容为例说明，具体如下。

• 集成接口的定义如下，并完成与集成流的绑定。

• 集成流中，将请求参数q1保存到消息的变量字段中，设置变量的节点配置如下：

• 对应的脚本内容如下，可获取到了接口的入参q1的值。

package bwiflu6pwj543473k0;

import com.alibaba.bwif.script.core.StepMessage
import com.alibaba.bwif.script.core.BwifHandler
import com.alibaba.bwif.script.core.protocol.http.HttpRequest
import com.alibaba.bwif.script.core.Entity

class SimpleHandler implements BwifHandler {
    @Override
    Object handle(StepMessage message) {
        HttpRequest req = message.getPayload()
        String q1 = req.getQueryParam("q1")
        return q1
    }
}

概述

您可以在本节点中定义调用集成接口获得的HTTP Response的内容。

节点配置

主要的节点配置信息为HTTP响应信息（Response），相关配置项详细说明如下：

使用示例

动态生成Entity对象，作为HTTP Response body的内容。具体示例请参见快速入门HTTP API Reply。

默认Response结构

引擎默认对返回的HTTP Response结构有统一约定，具体如下：

• Body部分。由开发者指定，通过HTTP API Reply节点中配置而来。

• Header部分。引擎默认会增加如下信息，用于方便排查问题。