中文English
跳到正文
WhenResets

Codex · 来源、历史与账户工具

接入公开档案

只读公开数据、明确的来源覆盖与版本化证据。此 API 不读取账户，也不保证个人额度已经恢复。

接口与稳定版本

GET 接口用途
/api/v1/archive当前保存快照：事件、分组统计、覆盖和更正。
/api/v1/archive?snapshot_id=ID读取先前保存的准确版本；不存在的版本返回错误。
/api/v1/archive/feed.xml公开动作 RSS，保留来源、核验与覆盖背景。
/api/v1/status · /api/v1/resets兼容旧 v1 输出。regular 分类不是已核验全局范围，新集成请优先使用 archive-v1。
/api/v1/tibo已采集 Tibo 发言、来源健康与近期背景信号。limit 参数限制返回帖子数量，不限制信号分类。
OpenAPI参数和错误参考。公开读取不需要 API key。

当前快照暂未加载成功，合约说明仍可阅读。

不要把未知变成 No

同时使用 data.today.state、data.coverage.state 与 checked_at。已记录动作仍需展示类型与核验状态。传输成功或新的 generated_at 不能证明近期覆盖完整。

const { meta, data } = await response.json();
const noRecord = data.today.state === "none-recorded"
  && data.coverage.state === "complete";
// Otherwise preserve "unknown". Never infer a personal account reset.
// Display coverage.checked_at, event verification and meta.snapshot_id.
  • meta.schema_version: archive-v1 · 对象结构版本。
  • meta.snapshot_id · 保存的语义版本，数据与覆盖判断不变时复用。
  • meta.generated_at · 保存版本首次生成的时间，不是重置时间。
  • event_id / announcement_id / revision · 稳定动作、共享公告与修订标识。合并来源时请保留。
  • verification_status / effective_at / affected_plans · 不要用推断的零点、套餐或全局范围填补未知值。

GET 错误返回问题详情与 HTTP 失败码。处理超时、400 无效参数、404 快照不存在、429 限流和数据不可用时，不要制造否定状态。

Tibo 信号字段

读取 /api/v1/tibo 的 data.signals，或 /api/v1/status 的 data.source_signals 与 data.signal_source。两者使用相同分类与来源元数据。信号是本人发言背景，不是重置事件或账户状态。

  • kind: explicit_reset_plan / reset_hint / plan_reopening / policy_change / release_teaser.
  • id / source_url / text / published_at · 保留原始证据与发布时间。正文有长度上限，不保证完整。
  • basis: captured_excerpt · 规则应用于已采集的本人正文。
  • relative_day · 可选的 today 或 tomorrow，保留作者用词，不假定时区。
  • expires_at · 发布 72 小时后的展示到期时间，不是执行截止时间。

同时展示来源的 checked_at、transport_ok 与 stale。来源故障时可能仍返回此前采集的信号；空 signals 数组不证明没有公告。信号不会创建重置档案记录或通知。

分类规则与覆盖限制

版本化下载

先读取 /api/v1/archive，再用返回的 snapshot_id 下载。保存的 JSON 与 CSV 来自同一版本。CSV 支持档案的 type、month、q 视图筛选，完整 JSON 保留定义与修订证据。

GET /api/v1/archive/export?snapshot_id=YOUR_SNAPSHOT_ID&format=json
GET /api/v1/archive/export?snapshot_id=YOUR_SNAPSHOT_ID&format=csv&type=banked

下载事件衡量请求，不证明用户已保存文件。来源链接点击与计算器成功是单独信号，不能当作通知确认。

嵌入公开状态徽标

把下面的 iframe 复制到网站或文档中即可使用。它每分钟读取轻量公开档案，并链接来源历史，无需 API key 或账户连接。来源覆盖未知时会继续显示未知。

<iframe title="Public Codex action status"
  src="https://whenresets.com/examples/codex-status-badge.html?embed=1"
  width="100%" height="320" loading="lazy"
  sandbox="allow-scripts allow-popups"
  style="border:0"></iframe>

组件展示公开记录与覆盖情况，个人额度是否可用仍需查看账户。修改示例时请保留署名与方法说明链接。

两个可运行的集成示例

  1. Node.js / 菜单栏状态示例

    保存模块后运行 node codex-reset-status.mjs。输出 UTC 日期、覆盖、快照与分类型的最近动作 ID，不需要私人账户输入。

  2. 浏览器状态徽标示例

    示例每分钟刷新公开记录，把覆盖缺失标为未知，并链接方法说明。刷新周期不代表来源每分钟更新。

署名与限制

请将元数据署名给 WhenResets，并链接所用快照与版本。复用许可覆盖本站元数据、分类与更正说明，不覆盖原作者帖子或第三方数据集。

下游产品请保留来源 URL 与不完整覆盖的说明。本站不保证排名、账户重置或预测结果。

完整复用与方法说明