---
title: 版本与历史查询
description: 使用 snapshot_id 选择完整数据版本、保持跨接口一致性并回看历史。
pageClass: gendangzou-doc
---

# 版本与历史查询

快照标识一组完成发布的板块目录、热度、公司映射、证据和资金数据。

## 使用场景

典型场景：

1. 多个接口必须使用同一组板块、热度、映射和资金数据。
2. 回看某个日期或复现历史结果。

## 选择版本

```http
GET /api/gendangzou/snapshots/latest
GET /api/gendangzou/snapshots/latest?as_of=YYYY-MM-DD
GET /api/gendangzou/snapshots?start=YYYY-MM-DD&end=YYYY-MM-DD
```

`as_of` 表示该日期或此前最近的完整版本。响应中的实际 `as_of` 和 `snapshot_id` 才是
后续调用应使用的值。

## 跨接口一致性

取得 `snapshot_id` 后，把它传给支持该参数的板块、信号、公司和证据接口：

```text
snapshot.latest
  -> signal.heat.rank?snapshot_id=...
  -> sector.detail?snapshot_id=...
  -> evidence.sector.list?snapshot_id=...
```

这样可以防止长任务执行期间恰好发布新版本，导致一次回答混入两个不同的数据状态。

## 精简响应

Agent 使用快照时建议显式传：

```text
detail=compact
```

需要附加上下文时再通过 `include` 选择：

| include | 内容 |
| --- | --- |
| `coverage` | 数据覆盖与完成度 |
| `sector_dynamics` | 板块异动和同日关联 |

## 发布期间

生产任务更新期间，API 继续提供上一份完整版本，不暴露正在写入的中间状态。