查询图纸来源与页面映射

读取某个来源文件的原始来源、视觉清单和已登记页面图,辅助核对检索证据。

GET https://api.moi.matrixorigin.cn/v5/drawings/{source_file_id}/provenance

调用前准备

MOI_ENDPOINT 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

使用检索结果的source_file_id和同一知识库ID、工作区及凭据。需要知识库semantic_model.use;路径不含workspace_id,仍须X-Workspace-ID。source_file_id不是drawing_number或drawing_id。

请求参数

curl --get "$MOI_ENDPOINT/drawings/$SOURCE_FILE_ID/provenance" \
  --header "X-API-Key: $AI_STUDIO_API_KEY" --header "X-Workspace-ID: $WORKSPACE_ID" \
  --data-urlencode "knowledge_base_id=42" --data-urlencode "page_number=1"

参数

位置

类型

必填

说明

source_file_id

路径

string

是

检索结果来源文件ID,按路径编码。

knowledge_base_id

查询

integer

是

正整数知识库ID。

page_number

查询

integer

否

指定时必须正数,仅检查此页是否存在,仍返回完整pages;不是只筛这一页。省略不作页存在检查。

成功响应

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "knowledge_base_id": 42,
    "source_file_id": "source-example",
    "external_source_uri": null,
    "visual_manifest_file_id": "manifest-example",
    "provenance_status": "ready",
    "gaps": [
      "external_origin_missing"
    ],
    "pages": [
      {
        "page_number": 1,
        "page_image_file_id": "page-1",
        "preview_url": "/semantic-models/42/artifacts/page-1/preview"
      },
      {
        "page_number": 2,
        "page_image_file_id": "page-2",
        "preview_url": "/semantic-models/42/artifacts/page-2/preview"
      }
    ]
  }
}

来源对象与状态展开字段、ready/legacy与缺口。ready不等于所有来源字段完整;200也不证明任意source_file_id存在或可下载。

错误响应

{
  "code": "ErrServiceUnavailable",
  "msg": "Service unavailable"
}

字段

类型

说明

code

string

页不存在时404/ErrDrawingPageUnavailable;参数400/ErrParamInvalid;权限/依赖见相关接口。

msg

string

普通本地化错误消息。上面是通用依赖不可用示例,不代表缺页错误。

最后更新于