图纸来源对象与缺口¶
字段 |
类型 |
说明 |
|---|---|---|
knowledge_base_id |
integer |
本次知识库。 |
source_file_id |
string |
查询的来源文件标识。 |
external_source_uri |
string 或 null |
来源URI;缺少可信值返回null,不是公网下载保证。 |
visual_manifest_file_id |
string 或 null |
视觉清单文件ID;缺少时null。 |
provenance_status |
string |
ready或legacy_unmigrated。 |
gaps |
string(字符串数组) |
已发现的来源缺口;没有返回[]。 |
pages |
object(对象数组) |
完整有效页面映射;缺少时[],不虚构预览页。 |
pages[].page_number |
integer |
正数页码。 |
pages[].page_image_file_id |
string |
完整页面图文件ID。 |
pages[].preview_url |
string |
受鉴权的相对API预览路径,用同环境网关和工作区凭据读取。 |
ready要求已有有效页面及视觉清单;external_source_uri缺失时仍可ready,同时gaps包含external_origin_missing。legacy_unmigrated可能表示旧schema/未迁移或部分缺口,不能用单一状态代替字段检查。未加载证据、字段null、空数组不是同一件事;检索结果中的来源字段还可能省略,独立溯源对象则显式返回null/数组。
gaps值 |
含义 |
|---|---|
drawing_provenance_schema_missing |
来源表/列尚缺,返回legacy,不当404 |
drawing_provenance_unmigrated |
没有文件记录及页面映射 |
drawing_page_missing |
没有有效正页码和页面图ID组合 |
visual_manifest_missing |
缺视觉清单ID |
external_origin_missing |
缺原始来源URI |
源表缺失优先报告schema缺口,不一定同时枚举所有空字段。未知source_file_id在可访问知识库中也可返回legacy/空页面,不能从200证明文件存在。指定不存在的page_number则返回404/ErrDrawingPageUnavailable。page_number只校验存在,不缩小pages数组。