按节点身份读取自定义算子源码¶
GET /workflow/v2/custom-operators/source,需要单个非空 X-Workspace-ID。传递规范的 node_id、version,可选 task_id;结果封套为字符串 code: "OK"、msg: "OK"、data。
两种来源¶
提供非空 task_id 时,只选择任务工作区来源,返回 origin: "workspace"。任务须属于当前工作区并有上下文,读取前重复核对任务及上下文。当前加载器只接受 version=draft,节点前缀为 moi:custom.operator:{workspace_id}:,后接有效标识符。从该任务工作区的算子目录读取 operator.json、main.py;输入输出 schema 必须为对象,manifest 严格校验。身份、handler 与语言由受信工作区推导,当前为 Python、main.handle。缺少任务文件不会回退到已保存算子。
该 GET 可以在工作区首次读取时从持久化快照恢复本地目录并写 readiness manifest;不能声称它完全没有本地文件系统写入。它不发布算子或开始运行。
不提供 task_id 时,按 node_id + version 精确查找当前租户中持久化的算子,返回 origin: "published"。查询最多取两条以识别歧义,要求恰好一条。这里的 published 是协议来源值,不独立证明算子已启用或工作流已发布。算子须为代码类型且有非空 SourceFileID;通过 Catalog 读取源码,空白内容无效。当前详情读取没有单独过滤 disabled 状态,不能补造仅启用算子可读取的限制。
两个来源分别经过生成的授权边界;不能根据选择来源的 Platform 内部调用推断 HTTP 入口免授权。
请求示例¶
从已有工作流节点取得精确节点身份和版本。只在读取任务工作区草稿时额外传当前 authoring 任务 ID:
curl --get "$PRODUCT_API_BASE_URL/workflow/v2/custom-operators/source" \
-H "X-API-Key: $PRODUCT_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--data-urlencode "node_id=$NODE_ID" \
--data-urlencode "version=$NODE_VERSION" \
--data-urlencode "task_id=$AUTHORING_TASK_ID"
读取持久化算子时省略最后一个参数。task_id 决定来源;不是草稿读取失败后的兜底提示。
PRODUCT_API_BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5。
字段 |
类型 |
必填 |
约束 |
|---|---|---|---|
|
string |
是 |
节点规范身份,非整数算子 ID;只出现一次,非空且无首尾空白 |
|
string |
是 |
与该身份精确匹配;只出现一次,非空且无首尾空白 |
|
string |
否 |
至多一次;非空时不能含首尾空白,空字符串按未提供处理 |
响应字段¶
字段 |
类型 |
说明 |
|---|---|---|
|
string |
源码全文,可能含敏感业务信息,应按代码与密钥规范保存 |
|
string |
|
|
string |
节点身份 |
|
string |
节点版本 |
|
string |
可省略,源码语言 |
|
string |
可省略,入口函数 |
|
string |
可省略,算子名称 |
|
string |
可省略,算子标识符 |
错误与待验¶
重复或空参数、非规范空白、无源码等映射 400/ErrParamInvalid,缺工作区头为400/ErrWorkspaceRequired。找不到持久化身份/任务、任务不匹配等沿服务错误映射;身份歧义及包装后的源码读取错误为500/ErrServer。任务目录中文件读取原始错误未统一转换为ErrNotFound,不要把所有缺文件场景都写成404。
前端共享函数注释仍写 draft 优先、published 兜底,与当前 service 分支不符;现有 Go/Python/CLI 测试固定值仍用 origin=draft。二者为维护候选,不能用其绿色测试确立协议枚举。