首页 / 行业

REST端口支持构建动态REST请求来使用RESTful API网络

2022-01-17 09:11:00

REST端口支持构建动态REST请求来使用RESTful API网络服务。

概览

REST端口暴露了一个简单的接口来为REST请求构建头、授权、主体和HTTP方法。请求体可以在端口配置中静态设置，也可以根据端口处理的文件动态生成。

端口配置

配置

与端口核心操作相关的配置。

方法&URL

REST请求的方法和目标网址。

认证

认证类型

REST服务使用的认证类型。有关更多详细信息，请参见认证部分。

头部

头部部分支持添加任意列表的HTTP头部，以包含在传出的REST请求中。头部被指定为名称-值对。当主体类型设置为Raw时，此部分可用于指定消息主体的Content-Type。

消息主体

与生成REST请求主体相关的设置。当HTTP方法设置为“GET”时不适用。

主体类型

None – REST请求不会提供给任何机构。 form-data – 主体以一组名称-值对(字段)的形式提供。如果字段设置为静态，则名称和值都在用户界面中指定。对于动态字段，名称是在用户界面中指定的，值是从连接器处理的输入文件中动态读取的。有关更多信息，请参见动态表单数据部分。 x-www-urlencoded – 主体的配置方式与form-data相同，但是名称-值对被编码为一个URL查询字符串，而不是多部分表单数据。 raw – 主体被设置为端口处理的输入文件的内容。正文的内容类型可以通过相关联的下拉菜单设置，或者在标题部分指定为自定义标题。

SSL服务器认证

与SSL服务器认证相关的设置。

SSL服务器证书

用于SSL/TLS服务器认证的公钥证书。此设置可以设置为“任何证书”，以无条件信任目标服务器的身份。

自动

与端口自动处理文件有关的设置。

发送	到达端口的文件是否会自动触发REST API调用。
重试间隔	重试失败的REST请求之前的时间。
重试最大尝试次数	将重试失败的REST请求的最大次数。
接收	端口是否应该根据指定的时间间隔自动发送静态REST请求。请求正文中将不包含任何动态值。
接收执行间隔	自动静态请求之间的间隔。
分钟	下载前等待的分钟数。仅在接收执行间隔设置为分钟时适用。
整点过几分	每小时计划的分钟偏移量。仅在接收执行间隔设置为每小时时适用。例如，如果该值设置为5，自动化服务将在1:05、2:05、3:05等处启动。
时间	给定日期内请求发送的时间。仅当接收执行间隔设置为每日、每周或每月时适用。
天	发送请求应该发生的日期。仅在接收执行间隔设置为每周或每月时适用。
cron表达式	表示cron表达式的任意字符串，用于确定发送请求应该何时发生。仅在接收执行间隔设置为高级时适用。

高级

本地文件夹

确定磁盘上发送/上传文件的文件夹以及接收/下载文件的文件夹的设置。

输入文件夹（Send）	端口可以发送/上传放在此文件夹中的文件。如果启用了自动发送，端口将自动轮询处理此文件夹中的文件。
输出文件夹（Receive）	端口会将接收/下载的文件放在此文件夹中。如果端口连接到工作流中的另一个端口，文件将不会保留在这里，而是传递到已连接端口的输入/Send文件夹。
已处理文件夹（Sent）	处理文件后，如果启用了保存到已发送文件夹，端口将在此文件夹中放置已发送/已上传文件的副本。

SSL客户端认证

需要双向SSL认证时与客户端认证相关的设置。

私钥证书	在SSL客户端认证期间的私钥证书。
证书密码	访问SSL客户端证书所需的密码。

其他配置

先前类别中未包含的配置。

HTTP版本	连接到REST服务时是使用HTTP 1.0、1.1还是2.0。
超时时长	引发超时错误之前等待REST服务器响应的持续时间(秒)。
使用分块编码	发送请求时是否使用HTTP分块传输编码。这允许应用程序顺序发送消息的部分(块)，以避免连接过载。
块大小	启用“使用分块编码”时，每个分块的大小(以字节为单位)。
日志级别	为端口生成的日志中包含的详细程度。
日志消息	发送文件中的日志是否包含文件本身的副本。
保存到已发送文件夹	端口发送的文件是否应复制到连接器的已发送文件夹。
启用SSL的协议	建立传出连接时支持的SSL/TLS协议列表。强烈建议仅使用TLS协议。一些过时的操作系统不支持TLS 1.2。