API 示例

Published On: 2020年4月23日Categories: 帮助文档, 知识库Views: 2

© All rights reserved. • 西安知行软件有限公司 • 陕ICP备09022277号

本章节包含了一些需要结合API 请求来完成的常见用例。

向Workflow中插入一个文件

POST到Files资源,将文件添加到指定端口的“Send”,“Receive”,“Sent”文件夹中。要将一个文件插入到工作流中,需要将这个文件POST到处理该文件的第一个端口的“Send”文件夹下,例如:

xml
POST http://mydomain.com:8001.com/api.rsc/files
json
{
"ConnectorId":"myConnector",
"Folder":"Send",
"Filename":"test.txt",
"Content":"VGhpcyBpcyBhIHRlc3Qu"
}

请注意,“Content”参数包括了文件的base64编码内容。

如果目标端口启用了自动发送,则文件会被自动处理。 否则,需要额外调用sendFile 函数,指示端口处理该文件。例如:

xml
POST http://mydomain.com:8001/api.rsc/sendFile
json
{
"ConnectorId":"myConnector",
"File":"test.txt"
}

检索特定事务的日志文件

getTransactionLogs 函数可以用来检索特定操作的日志文件。调用此函数需要知道相关事务的消息标识。可以通过查询Transactions 资源来找到消息标识(Transactions资源返回关于事务的元数据,但不返回事务日志文件本身)。

Transactions 资源的GET查询应该包括识别特定事务所需的过滤器(除非结果集可以被其他进程解析,以便找到所需事务的消息标识),例如:

xml
GET http://mydomain.com:8001/api.rsc/tansactions(connectorId='myAS2Connector',Filename='myFile.edi')

response的JSON主体将包括特定事务的消息标识。在getTransactionLogs 中使用此消息标识,以及其他必需的参数“ConnectorId”和“Direction”(发送或接收)。“Include Content”参数应设置为“True”,以便在response中包含日志文件的内容。例如:

xml
POST http://mydomain.com:8001/api.rsc/getTransactionLogs
json
{
"ConnectorId":"myConnector",
"Direction":"Send",
"MessageId":"message_id_from_earlier",
"IncludeContent":"True"
}

response的“Content”参数将保存base64编码的日志文件内容。

前往知行软件官网主页,了解更多。

了解更多EDI信息,请您电话 150-0298-3180 / 177-8250-8152 或邮件 edi@kasoftware.cn 联系我们。点击下方蓝色按钮,即可免费试用EDI软件。

注:文案部分图片及内容来源于网络,版权归原创作者所有,如有侵犯到您的权益,请您联系我们进行删除,给您带来困扰,我们深感抱歉。

为什么选择

知行之桥®?​

根据企业规模与集成需求,提供从本地部署到云端托管的灵活选择

可视化 EDI 工作流

基于拖拽式图形化设计器,零代码构建完整 EDI 业务流程,满足复杂供应链自动化场景。

Odette & Drummond 认证

通过 Odette(OFTP) 与 Drummond(AS2) 权威认证,确保与主机厂安全合规、高可靠的数据交换。

多系统集成能力

提供数据库、REST/SOAP、FTP/SFTP 等标准化接口,实现 ERP、WMS、MES 等系统的双向数据自动同步。

数据映射格式转换

内置可视化 Mapping 编辑器,零代码实现 EDI 报文与企业内部数据格式(XML/JSON…)的映射转换及复杂规则处理。

实时监控预警机制

全流程可视化监控报文状态,支持邮件、钉钉、企业微信自动预警,保障 JIT 交付的稳定性与及时性。

多工厂支持

支持集团级多组织、多工厂架构,实现数据隔离与权限管控,统一平台集中运维,满足大型制造企业多地点协同需求。