服务发现调试 URL(MacroController)¶
用于从 Consul 服务发现中查询 obpm-runtime 实例地址,拼接出后台脚本调试页面的跳转 URL,供设计器中调试 iScript 时使用。
- 接口类型:REST 资源
- 基址:无类级
@RequestMapping,端点路径自含 - Tag:设计器模块
公共说明¶
- 鉴权:需在设计器登录后携带
designerToken。鉴权机制详见 ../index.md。 - 响应封装:**不使用**统一
Resource结构,直接将Map<String,String>序列化为 JSON 对象返回(见下方响应说明)。
1. 获取服务运行时URL¶
通过 Consul 服务发现查询 obpm-runtime 服务实例,取首个实例拼接出脚本调试页面 URL。
- 接口类型:REST 资源
- 请求方式:
GET - 请求路径:
/api/macro/runtime/consul/debug/url(完整:{designer-context}/api/macro/runtime/consul/debug/url) - 鉴权:是(需 designerToken)
- Tag:设计器模块
请求参数¶
无。
请求示例¶
响应¶
结构:直接返回 JSON 对象(非 Resource 封装),形如 { "status": "ok", "url": "<runtime调试URL>" };当 Consul 未注册任何 obpm-runtime 实例时,响应体为 null(HTTP 200)。
字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| status | string | 固定 "ok",表示成功获取到运行时实例 |
| url | string | <host>:<port><contextPath>/macro/debug.html,用于重定向到运行时调试页面 |
成功示例:
无实例示例(Consul 中找不到 obpm-runtime,方法返回 null):