完整数据总览
状态摘要、预测、信号、历史与来源元数据。适合作为应用的首个请求。
01 / 接口列表
JSON接口一览
按用途选择数据，避免重复抓取同一份上游公告。
重置相关信号
从公开动态中筛选重置、计划、提示与额度消息，保留分类与验证状态。
重置公告历史
已收录的重置公告；公告完成不等同于本地账户额度已核实。
GET
/api/v1/tibo Tibo 公开动态
全部已收录的有效帖子，包含原文、发布时间、链接与采集模式。
GET
/api/health 服务健康状态
检查服务与数据源是否可用，供部署探针与定时任务调用。
永久发言历史
逐帖持久化的原始发言及采集来源，支持分页读取；不保证首次采集前的历史完整。
实验概率模型
返回历史基线、实验调整与逐帖影响；规则未经校准，原始预测接口仍保持上游基线。
字段:
/api/v1/overviewprobability_model → baseline / adjusted / factors / model_version / evaluated_attibo_history → total / persistent / complete_history查询参数
筛选与分页
适用于 signals、resets、tibo 列表接口。
| 参数 | 说明 |
|---|---|
limit / offset | limit 为 1–100，默认 50；offset 从 0 开始。返回 next_offset 供下一页使用。 |
kind | kind 可选 reported_completed、planned、hint、limits、banked、unclear、needs_context 或 other；type 为兼容别名。 |
q | 关键词检索，最多 200 字。 |
from / to | UTC 日期范围，格式为 YYYY-MM-DD。 |
列表响应包含 items、count、total、limit、offset、next_offset。查看筛选示例 ↗
02 / 解读响应
先检查状态，再使用数据。
| 字段 | 如何理解 |
|---|---|
available | 当前是否有可用的数据快照。不可用时请展示明确的空状态。 |
stale | 是否来自过期缓存。保留数据时也应告知用户其时效。 |
generated_at | 本次接口响应生成时间，不能替代帖子发布时间或采集时间。 |
channels | 按来源记录 fetched_at、checked_at、可用性与错误。 |
posts | 原文、原始 URL、发布时间、分类，以及帖子验证状态。 |
quota_verified | 是否核实账户实际额度。值为 false 时不可呈现为「额度已恢复」。 |
tibo.mode | x_api、third_party_copy 或 unavailable，区分直接采集与第三方副本。 |
预测字段 probability_24h / probability_48h 为 0–100 的百分比。没有可用预测时请显示未知值，勿以 0% 代替。
03 / 接入示例
一个最小接入示例。
GET 读取接口无需认证，允许跨域调用。
const response = await fetch(
'https://codexreset-news.com/api/v1/overview',
{ headers: { Accept: 'application/json' } }
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
if (!data.available) {
// 展示「数据暂不可用」，不要推断没有重置。
} else {
const posts = data.tibo?.items ?? data.posts ?? [];
const cached = data.stale === true;
// 显示原始链接，并保留第三方数据署名。
}采集刷新接口单独鉴权；前端无需持有采集密钥。查看当前服务状态 ↗
04 / 兼容接口
兼容现有调用。
旧接口继续提供数据。新接入建议使用版本化的 v1 接口。