按材料查询公司映射证据
evidence.relation_materials.list
将同一文档中的公司业务事实归并展示，是 Agent 的推荐映射审计接口。
调用契约
| 项目 | 值 |
|---|---|
| Method | GET |
| Path | /api/gendangzou/company-sector-relations/{relation_id}/evidence-materials |
| 业务域 | evidence |
| 数据更新 | 随完整数据版本发布 |
受控意图：trace_company_relation、audit_company_mapping
请求参数
| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
|---|---|---|---|---|
relation_id | path | string | 是 | 最短 8 字符；最长 128 字符 |
page | query | integer | 否 | 从 1 开始的页码；默认 1；最小 1 |
page_size | query | integer | 否 | 默认 20；最小 1；最大 100 |
snapshot_id | query | string | 否 | 最短 8 字符；最长 128 字符 |
as_of | query | string | 否 | 返回此日期或此前最近的完整快照；格式 date |
detail | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 full；可选 full、compact |
include | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |
最小调用
bash
curl --fail --silent --show-error \
-H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
"https://api.mobiusquant.ai/api/gendangzou/company-sector-relations/<relation_id>/evidence-materials?page_size=10&detail=compact"将路径中的 <...> 替换为实际资源 ID。
响应
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
snapshot | SnapshotContext / SnapshotReference | 是 | 本次查询实际使用的数据版本。 |
summary | RelationEvidenceMaterialSummary | 是 | 当前查询的聚合统计。 |
items | array<RelationEvidenceMaterial> | 是 | 当前查询返回的结果列表。 |
pagination | Pagination | 是 | 分页位置、总数和总页数。 |
RelationEvidenceMaterialSummary
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
material_count | integer | 是 | 支撑当前结果的独立原始材料数量。 |
fact_count | integer | 是 | 归并材料包含的公司业务事实数量。 |
RelationEvidenceMaterial
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
material_key | string | 是 | 归并材料的稳定标识。 |
material_id | string / null | 否 | 归并后材料的主标识。 |
document_id | string / null | 否 | 公司正式披露文档标识。 |
source_id | string | 是 | 材料来源标识。 |
evidence_date | string | 是 | 证据对应日期。 |
publish_date | string | 否 | 原始公司材料发布日期。 |
report_period | string | 否 | 公司正式披露材料对应的报告期。 |
document_type | string | 否 | 财报、公告或问询回复等文档类型。 |
title | string | 是 | 原始材料标题。 |
url | string | 是 | 原始材料 URL。 |
fact_count | integer | 是 | 归并材料包含的公司业务事实数量。 |
facts | array<RelationEvidenceFact> | 否 | - |
RelationEvidenceFact
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
evidence_id | string | 是 | 可溯源证据标识。 |
fact_name | string | 否 | 公司业务事实名称。 |
fact_summary | string | 否 | 公司业务事实摘要。 |
fact_type | string | 否 | 公司业务事实类型。 |
business_status | string | 否 | 材料所述业务的当前状态。 |
evidence_level | string | 否 | 公司事实证据强度等级。 |
participation_basis | string | 否 | 公司参与该产业环节的材料依据。 |
participation_summary | string | 否 | 公司在板块价值链中的参与方式。 |
relationship_logic | string | 否 | - |
mapping_conclusion | string | 否 | - |
boundary_note | string | 否 | 关系成立范围及不能外推的边界。 |
viewpoint | string | 否 | 系统从材料中抽取的产业观点。 |
quote | string | 否 | 支撑观点或事实的原文摘录。 |
role | string | 否 | - |
confidence | string / number / null | 否 | 结果置信度；不能与关系分或热度分互换。 |
score | number / null | 否 | 公司业务事实与板块定义的关系强度。 |
score_breakdown | object | 否 | - |
mapping_explanation | MappingExplanation / null | 否 | 公司业务事实、映射逻辑、边界和结论。 |
term_explanation | TermExplanation / null | 否 | - |
MappingExplanation
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
fact | string | 否 | - |
logic | string | 否 | - |
participation_summary | string | 否 | 公司在板块价值链中的参与方式。 |
boundary_note | string | 否 | 关系成立范围及不能外推的边界。 |
conclusion | string | 否 | - |
participation_basis | string | 否 | 公司参与该产业环节的材料依据。 |
TermExplanation
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
canonical_name | string | 是 | 术语规范名称。 |
category | string | 是 | 对象或关系分类。 |
definition | string | 是 | 板块定义。 |
source_title | string | 是 | - |
source_url | string | 是 | - |
调用要点
- Agent 建议使用
detail=compact控制上下文体积。 - 分页从
page_size=10开始，确认需要后再继续翻页。