[Share] API 示例

本章节包含了一些需要结合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 联系我们,获取 30 天全功能 免费试用 版本EDI软件。
标签: , , , , ,
文章分类 share 知识分享, 动态