完整資料總覽
狀態摘要、預測、訊號、歷史與來源後設資料。適合作為應用的首個請求。
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 介面。