业务实体服务指南

上一个下一个

REST 统一资源定位器

您可以使用 REST URL 对业务实体服务执行 REST 调用。

REST URL 使用以下语法：

http://<host>:<端口>/<上下文>/<数据库 ID>/<路径>

URL 包含以下字段：

主机: 正在运行数据库的主机。
端口: 数据库侦听器所使用的端口号。
context: 业务实体、搜索、查询、匹配、任务和层次结构 API 的上下文为
cmx/cs
。; 匹配列 API 的上下文为
cmx
。; 文件 API 的上下文为
cmx/file
。; 任务 API 的上下文为
cmx/task
。; 批量任务管理 API 的上下文为
cmx/task/operations
。; 任务关系 API 的上下文为
cmx/bulk
。; 图表报告 API 的上下文为
cmx/report
。; 在托管 MDM 环境中，请在上下文中加入租户名称。例如，上下文可以是
<租户名称>/cmx/cs
或
<租户名称>/cmx/file
。
database ID: 在 Hub 控制台的“数据库”工具中注册的 ORS 的 ID。
path: 您要使用 API 的对象，例如记录、任务或文件。; 如果 URL 用于根记录，则路径是根对象名称后跟唯一标识符。

以下是 Person 根记录的路径的示例：
Person/798243.json
。; 如果 URL 用于根对象直接子代的记录，则路径还包含子记录名称和唯一标识符。
以下是帐单地址记录（属于 Person 根记录的子代）的路径示例：

Person/798243/BillAddresses/121522.json
。; 如果 URL 用于深度为 2 或以上的子记录，则路径还包含深度。

以下 URL 是深度为 2 的子记录的 REST URL 示例：

http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/798243/BillAddresses/121522.json?depth=2

参数区分大小写。请确保 REST URL 中参数名称的大小写与 REST 配置中参数名称的大小写匹配。

发送反馈