REST端口

2022-02-14 17:54:10 浏览数 (2)

API是Application Programming Interface(应用程序接口)的缩写,它是拿来描述一个类库的特征或是如何去运用它。按照目前比较主流的分法,可以分为REST API和非REST API。知行之桥中的API端口主要支持对象就是REST API。

什么是REST API?

首先,REST是一种架构风格。REST API就是选择通过使用http协议和uri,利用C/S(客户端/服务器) 模型对资源进行增删改查操作。而其中客户端和服务器是分离的,而知行之桥中的REST端口就是作为REST API中的客户端,对服务器发起操作请求的。

如何使用REST端口?

1. 准备工作

按照REST API的描述,需要确认以下信息:

1.1 http协议 1.2 URI 1.3 方法 1.4 认证 1.5 请求和响应的数据格式

2. 配置

2.1 URL

2.2 方法

2.3 认证

支持的认证类型有None,Basic,NTLM,Digest,OAuth2,Bearer,AWSSignature等。

2.4 请求和响应数据

3. 测试

本次将使用知行之桥的admin API作为示例,接口文档可参考知行之桥页面:api.rst 本次使用的接口目的是上传文件到指定端口。

接口URL: http://localhost:8014/api.rsc/files/ 操作:POST

数据格式:JSON

Token认证:

根据参数列表:

整理对应的请求内容:

1234567

{"ConnectorId": "Nina", "Folder": "Send", "Filename": "test.txt", "MessageId": "MessageId_1","Content": "VGhpcyBpcyBhIHRlc3QgZmlsZQ=="}

将请求内容保存成文件后,在REST端口的输入页面中上传并发送:

将在端口Nina的输入中生成一个文件:

常见问题:

1. 需要自动使用GET方法获取数据

在配置和调试完成后,在REST端口-》自动化设置页,勾选自动化设置-》接收,并预设自动轮询时间即可。

2. 需要使用POST方法自动获取数据

需要在REST端口前加一个script端口,用于生成需要发送的请求数据,并勾选自动化-》接收。Script端口的箭头指向REST端口。

总结:

1.拿到REST API接口文档; 2.按照接口文档配置REST端口; 3.根据接口文档中的属性列表或测试文件整理请求数据; 4.发送请求数据,进行调试。

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

0 人点赞