# 新建中介接口
- 选择左侧树上中介服务节点,点击API创建按钮,选择右侧的”API编排“页签,点击”API编排“按钮,进入在线编排页面。
- 1.1. 或者点击中介服务,点击API编排按钮进入在线编排页面。如下图:
- 在线编排页面中,在通用业务目录上点击右键,点击新建,点击新建HTTP接口,然后如下图所示填写数据,其中代理URI填写符合规则的接口地址,并点击确定保存。
# 接口在线编排
- 保存成功后系统自动打开中介编排页面,如下图所示。从左侧拖一个赋值取图元、一个HTTP业务服务图元和一个值获取图元到开始和结束图元中间并依次连接各个图元。如下图:
- 双击编排背景画布,进入属性编辑页面,点击“变量定义”右侧的“添加变量”按钮,新增变量
字符串类型的 random_from_header
(主要用于从header中获取参数值)、字符串类型的 random_to_header
(主要用于通过引用方式传值给下一个接口)、字符串类型的 version_value
(主要用于常量传值给下一个接口) 注意:变量名必须符合java变量命名规则,点击“确定”按钮。如下图:
- 双击值获取图元,进入编辑页面,点击“从协议头获取“页签,点击右侧的“添加“按钮,在“左值“列下拉选择上一步定义的变量
random_from_header
,在“右值“列输入header中的参数名称, 这里示例名称为X-RANDOM
,这样定义之后,此图元的左值就被赋值为请求header中的X-RANDOM
参数值,参数选择outMessage
,返回值选择outMessage
,点击“确定”按钮保存。如下图:
- 双击赋值取图元,进入编辑页面,点击“编辑参数“右侧的“添加基本属性“按钮两次,编辑第一行参数,在“左值“列下拉选择上一步定义的变量
random_to_header
,在“右值“列输入random_from_header
, 右值类型选择“变量“,然后再编辑第二行参数,在“左值“列下拉选择上一步定义的变量version_value
,在“右值“列输入910
,右值类型选择“常量“,点击“确定”按钮保存。如下图:
- 双击打开HTTP业务服务图元,进入编辑页面,点击“业务接口“右侧的“选择“按钮,在弹出的选择接口页面选择
get /users/xml
接口,然后点击确定。回到HTTP业务服务属性设置页面, 参数选择inMessage
,返回值选择outMessage
,点击“Headers“页签下操作栏的“添加“按钮两次,编辑新增的第一行参数输入栏,参数名填写期望的header名称,这里示例值为X-VERSION
,值填写version_value
, 操作类型选择赋值
,类型选择String
,值类别选择变量
,编辑新增的第二行参数输入栏,参数名填写期望的header名称,这里示例值为X-VAR-RANDOM
,值填写random_to_header
, 操作类型选择赋值
,类型选择String
,值类别选择变量
,点击“确定”按钮保存。如下图:
说明:
1. 通过值获取图元,从请求头`X-RANDOM`中获取,并赋值给`random_from_header`变量。
2. 通过赋值图元将`random_from_header`的值赋值给`random_to_header`变量。
3. 通过赋值图元将常量`910`赋值给`version_value`变量。
4. 通过http业务服务图元新增headers参数,将`version_value`变量的值赋值给`X-VERSION`,将`random_to_header`变量的值赋值给`X-VAR-RANDOM`。
5. http业务服务图元执行调用接口的时候,会将`X-VERSION`和`X-VAR-RANDOM`作为请求头参数,并携带初始请求头中的`X-RANDOM`参数值。
- 点击右上角“保存”按钮或者按Ctrl+S快捷键,系统提示保存成功。如下图: