Сводка состояния, прогнозы, сигналы, история и метаданные источников. Подходит для первого запроса приложения.
Обзор API
Выбирайте данные по задаче, чтобы не собирать одно и то же объявление из внешнего источника повторно.
Отбирает из открытых публикаций сообщения о сбросах, планах, намёках и лимитах, сохраняя категорию и статус проверки.
Собранные объявления о сбросах. Объявление о завершении не означает, что лимит личного аккаунта проверен.
/api/v1/tibo Все собранные действительные публикации с оригинальным текстом, временем публикации, ссылкой и режимом сбора.
/api/health Проверяет доступность сервиса и источников данных. Подходит для проверок при развёртывании и задач по расписанию.
Постоянное хранение оригинальных сообщений и источников сбора с постраничной выдачей. Полнота истории до первого сбора не гарантируется.
Возвращает историческую базу, экспериментальную корректировку и влияние каждого сообщения. Правила не калиброваны; исходный API прогнозов сохраняет базу источника.
/api/v1/overviewprobability_model → baseline / adjusted / factors / model_version / evaluated_attibo_history → total / persistent / complete_historyФильтрация и пагинация
Применяется к API списков 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. |
Сначала проверьте состояние, затем используйте данные.
| Поле | Как понимать |
|---|---|
available | Есть ли сейчас доступный снимок данных. Если нет, явно покажите состояние отсутствия данных. |
stale | Получены ли данные из устаревшего кеша. При сохранении данных также сообщайте пользователю об их актуальности. |
generated_at | Время формирования текущего ответа API. Оно не заменяет время публикации или сбора записи. |
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%.
Минимальный пример подключения.
GET API для чтения не требует аутентификации и допускает запросы с других доменов.
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;
// Показывайте оригинальную ссылку и сохраняйте указание стороннего источника данных.
}Совместимость с существующими запросами.
Старые API продолжают предоставлять данные. Для новых интеграций рекомендуется версионированный API v1.