查询图纸来源与页面映射¶
读取某个来源文件的原始来源、视觉清单和已登记页面图,辅助核对检索证据。
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 |
普通本地化错误消息。上面是通用依赖不可用示例,不代表缺页错误。 |
最后更新于