Search

资源

Version 24.3.9111

资源

概览

资源是在系统 API 中公开的对象，可以查询，创建，更新和删除。这些资源包括：

  • Files 检索知行之桥工作流程中的文件，或将文件推送到知行之桥工作流程中（将它文件添加到端口的 Send 文件夹中）。
  • Certificates 检索或更新用于加密，签名，解密，验证，TLS／SSL等的数字证书。
  • Connectors 检索或更新现有端口的配置，或向知行之桥工作流添加新的端口。
  • Transactions 从事务日志中检索元数据，记录成功和失败的文件传输（发送和接收）。
  • Logs 从知行之桥日志中检索日志数据，知行之桥日志中记录了应用程序级错误。
  • Profile 检索或更新知行之桥本地配置文件的配置。
  • Requests 从访问日志中检索记录 HTTP 请求的日志数据。
  • Workspaces 检索或创建工作区以将端口组合在一起。

可在以下知行之桥接口处公开访问每个资源： /api.rsc/resourceName. 例如，如果知行之桥托管在 “mydomain.com” 上并在侦听端口 8001，则以下接口可以访问 Files Resource：

http://mydomain.com:8001/api.rsc/files

资源访问方法

本节介绍用于访问系统 API 公开的资源的 HTTP 方法。

GET

HTTP GET 请求可用于从知行之桥检索资源或资源集。GET 请求可以返回多行，也可以仅返回单行，具体取决于请求中是否指定了查询参数。

不带参数的 GET 请求

不包含查询参数的 GET 请求将返回该 Resource 类型的所有实例。例如，如果对 Certificates 资源进行了不带查询参数的 GET 请求，则响应将包括知行之桥中保存的每个证书； 与 Connectors 资源类似的请求将返回知行之桥工作流中每个已配置端口实例的配置数据。

不带参数的 GET 请求的目标 URL 应与资源接口相同：

GET http://mydomain.com:8001/api.rsc/certificates

带参数的 GET 请求

GET 请求可以在目标 URL 中包含查询参数，可以将结果集限制为目标资源的单个实例。例如，对 Files 资源的 GET 请求可以包括特定的端口，Folder 和 Filename 参数，以检索由该端口处理的某个文件。查询参数在目标URL末尾的括号中指定，例如:

GET http://mydomain.com:8001/api.rsc/files(connectorId='myConnector',Folder='Receive',Filename='myFile.txt')?@authtoken=myAuthTokenValue

知行之桥用户界面内的 API Browser 中详细介绍了每种资源的可用参数。

POST

HTTP POST 请求可用于在知行之桥中创建指定资源的新实例。例如，向 Files 资源发出 POST 请求会将一个文件插入到知行之桥的工作流中，向 Connectors 资源发出 POST 请求将在工作流中创建一个新配置的端口。

新资源的参数以 JSON 格式作为 POST 的正文提供。该请求必须包含适当的内容类型头部 (比如 application/json) ，以便正确解释 POST 正文。知行之桥用户界面内的 API Browser 中详细介绍了每种资源的可用属性。以下是 Connectors 资源的示例 POST 正文:

{
	"ConnectorId":"myNewConnector",
	"ConnectorType":"Zip",
	"Workspace":"Default",
}

connectors 资源还根据指定的 ConnectorType 值支持其它属性。通过在 JSON 正文中加入字段名称和值，可以在 POST 调用期间设置任何可配置的端口字段。例如，当创建一个新的 Zip 端口时，该端口的 “Operation” 字段可以设置为 Decompress：

{
	"ConnectorId":"myNewConnector",
	"ConnectorType":"Zip",
	"Workspace":"Default",
	"Operation":"Decompress"
}

POST 请求的目标 URL 应与资源接口相同：

POST http://mydomain.com:8001/api.rsc/connectors

PUT

HTTP PUT 请求可用于更新知行之桥中指定资源的实例。例如，向 Connectors 资源发出 PUT 请求将更新知行之桥工作流中某个已配置端口的设置。

PUT 请求需要目标 URL 中的查询参数和 PUT 的 JSON 正文中的属性的组合。URL 中的查询参数确定要更新资源的哪个实例（例如，要更新哪个端口），而 JSON 属性确定该资源中要更新的字段（例如，应将哪个端口配置字段设置为新值）。

查询参数在目标 URL 末尾的括号中指定，例如：

PUT http://mydomain.com:8001/api.rsc/connectors(ConnectorId='myZipConnector')

请求的 JSON 正文包括针对目标资源实例进行更新的特定资源的字段。该请求必须包含适当的内容类型头部（例如 application/json），才能正确解释 PUT 主体。

以下是用于更新 Zip 端口实例的 “Operation” 字段的 PUT 请求的 JSON 主体示例：

{
  "Operation":"Compress"
}

DELETE

HTTP DELETE 请求可用于从知行之桥中删除指定资源的实例。例如，对 Files 资源发出 DELETE 请求将从知行之桥工作流程中删除一个文件。

DELETE 请求需要在目标 URL 中加入查询参数，以标识要删除的资源的实例。查询参数在目标 URL 末尾的括号中指定，例如：

DELETE http://mydomain.com:8001/api.rsc/files(connectorId='myConnector',Folder='Send',Filename='myfile.txt')

知行之桥用户界面内的 API Browser 中详细介绍了每种资源的可用参数。