Flow API搭建指南

搭建Flow API，首先需要安装知行之桥EDI系统，注意，Flow API为新增功能，仅在2022版本（8336）及以后支持，如果你发现正在使用的产品没有这个功能，可以在我们官网下载最新版本或者联系我们，进行版本升级。

支持版本：知行之桥® 2022 – 22.0.8336.0以及更高版本。

1.点击知行之桥EDI系统主界面右上角的齿轮图标，进入 用户 选项卡，点击添加，新建一个管理员角色的用户，并勾选API访问选项。

2.在 添加用户 页面中，注意黄色提示框中出现的文字：“因安全原因，现在将是令牌最后一次明文显示。请在保存更改前妥善保存此令牌。如果令牌丢失，可以随时再重建新的令牌。”我们需要将身份认证令牌Authtoken妥善保管，后期进行API调用时，将会用到。点击保存变更。

3.创建名为FLow_API的工作区

4.在知行软件官网，点击 EDI解决方案 ，即可下载示例文件。这里我们以EDI&XML格式转换为例，下载示例工程以及示例X12文件。

5.将上述获得的示例工程导入我们创建好的Flow_API工作区中。点击右上角齿轮图标，点击导入工作区。

6.同时选中需要加入Flow API的多个端口。在 工作流 界面点击第四个按钮（选择多个端口）

7.选中工作区中的两个端口，点击鼠标右键可以看到 创建工作流API 选项。

8.在弹出的界面中可以看到方法是POST，我们还可以自定义路径名称，这里我们将其命名为X12ToXML，点击 创建工作流API 选项。

9.工作流API创建效果如图：

10.点击工作流API右上角的播放图标，即可进入到API调用界面。

主体 部分可以上传输入文件，输出文件的处理结果会显示在右侧的 响应 部分。

在主体部分，将我们上文在官网下载的X12示例文件粘贴进来，点击运行。

ISA*00*          *00*          *ZZ*WAYNE_TECH     *ZZ*ACME           *160609*1330*U*00401*000000007*0*T*>~
GS*PO*WAYNE_TECH*ACME*20160609*1330*7*T*004010~
ST*850*0001~
BEG*00*DS*0476696888**20150708~
REF*SB*ZZ11~
REF*6P*ZZ~
REF*8M*0056~
REF*CR*1070335099~
REF*CO*7109790082~
PER*CN*ACME, Inc.*TE*(555) 555-5555~
CSH*SC~
SAC*C*ZZZZ**********06~
TD5*Z*2*123456~
N9*PD*ZCOF~
MSG*Thanks!~
N1*BY*Wayne Tech*92*5601~
N2*Wayne Tech*~
N3*125 WayneHigh Road.~
N1*EN*ACME, Inc.~
N1*ST*Wayne Tech Plant 1*92*0000505462~
N2*Wayne Tech Plant 1*~
N3*100 Wayne Ave.~
N4*Chapel Hill*MX*27514*US**~
PO1**500000*EA*495*TP*BP*337S3744*VP*422242224~
PID*F****500,000 red widgets****EN~
SCH*500000*EA***002*20180708~
PO1**100*EA*395*HP*BP*337S3745*VP*422242226~
PID*F****100 blue widgets****EN~
SCH*100*EA***002*20180708~
PO1**500*EA*210*TP*BP*337S3746*VP*422201210~
PID*F****AH-0310 red widgets****EN~
SCH*500*EA***002*20180708~
PO1**150*EA*350*TP*BP*337S3747*VP*422241452~
PID*F****F-100 blue widgets****EN~
SCH*100*EA***002*20180708~
PO1**500000*EA*495*TP*BP*337S3748*VP*422244512~
PID*F****HU-021 black widgets****EN~
SCH*500000*EA***002*20180708~
PO1**1500*EA*3000*HP*BP*337S3749*VP*422241023~
PID*F****100-20J widgets****EN~
SCH*100*EA***002*20180708~
CTT*6*500100~
SE*39*0001~
GE*1*7~
IEA*1*000000007~

11.点击运行，即可在右侧看到转换后的XML文件。

以上是在知行之桥EDI系统内部的API操作演示，企业也可以使用Postman等工具访问上文我们创建的API。

Postman调用演示

1.通过Postman调用Flow API，与调用知行之桥AdminAPI类似，需要在Headers处配置参数x-arcesb-authtoken，值为分配的用户令牌，方法设置为POST，URL与Flow API 设置页面中保持一致。

2.在Body处上传X12示例文件，选择 raw。

3.点击Send，如果遇到报错：”The content-type text\/plain is not allowed executing the API X12ToXML.”可以在Headers处取消Content-Type的勾选。

4.成功发送之后，则可以看到转换后的XML文件，如下图所示：

Q&A

如果出现无法调用的情况，可以点击知行之桥EDI系统的齿轮图标，在系统API中，添加受信任的IP地址，如果设为*，则表示可用于匹配任何IP地址。出于安全性考虑，这里应配置为需要访问此API的IP地址即可。

按照以上步骤，我们成功搭建了Flow API，并通过Postman工具实现了X12报文到XML之间的转换。如果你希望了解更多EDI相关信息，欢迎交流。

更多 EDI 信息，请参阅: EDI 是什么？

 阅读原文