# 查询图纸来源与页面映射

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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

```text
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。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
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"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| source_file_id | 路径 | string | 是 | 检索结果来源文件ID，按路径编码。 |
| knowledge_base_id | 查询 | integer | 是 | 正整数知识库ID。 |
| page_number | 查询 | integer | 否 | 指定时必须正数，仅检查此页是否存在，仍返回完整pages；不是只筛这一页。省略不作页存在检查。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "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"
      }
    ]
  }
}
```

:::::
:::::{tab-item} 字段说明

[来源对象与状态](provenance-results.md)展开字段、ready/legacy与缺口。ready不等于所有来源字段完整；200也不证明任意source_file_id存在或可下载。
:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code | string | 页不存在时404/ErrDrawingPageUnavailable；参数400/ErrParamInvalid；权限/依赖见[相关接口](index.md)。 |
| msg | string | 普通本地化错误消息。上面是通用依赖不可用示例，不代表缺页错误。 |

:::::
::::::
:::::::
