공개 신호. 공유되는 맥락.

같은 신호로 프로젝트를 연결하세요.

Codex Reset News API · 공개 공지, 예측, 출처 상태를 한곳에서 제공하는 API 작업 공간.

신호 레이더로 돌아가기
REST API v1

여기에서 시작하세요.

API는 구조화된 JSON을 반환하며 날짜는 ISO 8601 UTC 형식을 사용합니다. 연동하는 프로젝트는 이 사이트에서 수집한 공개 데이터를 공유하고, 출처의 사용 가능 여부와 캐시 만료 여부를 확인할 수 있습니다.

기본 URLhttps://codexreset-news.com
첫 번째 요청 / curl
curl -H 'Accept: application/json' \
  https://codexreset-news.com/api/v1/overview

브라우저에서 현재 실제 응답 보기 ↗

01 / 엔드포인트

API 목록

용도에 맞는 데이터를 선택하여 같은 상위 출처의 공지를 중복 수집하지 않도록 하세요.

JSON
전체 데이터 개요

상태 요약, 예측, 신호, 기록, 출처 메타데이터를 제공합니다. 앱의 첫 번째 요청으로 적합합니다.

초기화 관련 신호

공개 게시물에서 초기화, 계획, 힌트, 사용 한도 소식을 필터링하고 분류와 확인 상태를 보존합니다.

초기화 공지 기록

수집된 초기화 공지입니다. 완료 공지가 있어도 개인 계정의 사용 한도가 확인되었다는 뜻은 아닙니다.

Tibo 공개 게시물

수집된 모든 유효 게시물로, 원문, 게시 시간, 링크, 수집 모드를 포함합니다.

서비스 상태

서비스와 데이터 출처의 사용 가능 여부를 확인합니다. 배포 상태 점검 및 예약 작업에서 호출할 수 있습니다.

발언 영구 기록

원문 발언과 수집 출처를 영구 저장하며 페이지별 조회를 지원합니다. 최초 수집 전 기록의 완전성은 보장하지 않습니다.

실험적 확률 모델

과거 기준값, 실험적 조정과 발언별 영향을 반환합니다. 규칙은 보정되지 않았으며 기존 예측 API는 상위 출처 기준값을 유지합니다.

필드: /api/v1/overview
probability_model → baseline / adjusted / factors / model_version / evaluated_at
tibo_history → total / persistent / complete_history
쿼리 매개변수

필터링 및 페이지 구분

signals, resets, tibo 목록 API에 적용됩니다.

매개변수설명
limit / offsetlimit은 1–100이며 기본값은 50입니다. offset은 0부터 시작합니다. 다음 페이지에 사용할 next_offset을 반환합니다.
kindkind는 reported_completed, planned, hint, limits, banked, unclear, needs_context 또는 other를 선택할 수 있습니다. type은 호환용 별칭입니다.
q키워드 검색, 최대 200자.
from / toUTC 날짜 범위, 형식: YYYY-MM-DD.
목록 응답에는 items, count, total, limit, offset, next_offset이 포함됩니다.필터링 예시 보기 ↗
02 / 응답 이해하기

상태를 먼저 확인한 뒤 데이터를 사용하세요.

필드의미
available현재 사용할 수 있는 데이터 스냅샷이 있는지 나타냅니다. 없으면 데이터가 없다는 상태를 명확하게 표시하세요.
stale만료된 캐시에서 가져왔는지 나타냅니다. 데이터를 유지하더라도 최신성은 사용자에게 알려야 합니다.
generated_at이번 API 응답이 생성된 시간입니다. 게시 시간이나 수집 시간을 대신할 수 없습니다.
channels출처별로 fetched_at, checked_at, 사용 가능 여부, 오류를 기록합니다.
posts원문, 원본 URL, 게시 시간, 분류, 게시물 확인 상태.
quota_verified계정의 실제 사용 한도를 확인했는지 나타냅니다. 값이 false이면 ‘사용 한도 복구됨’으로 표시하면 안 됩니다.
tibo.modex_api, third_party_copy 또는 unavailable로 직접 수집과 제3자 사본을 구분합니다.

예측 필드 probability_24h / probability_48h는 0–100의 백분율입니다. 사용할 수 있는 예측이 없으면 알 수 없음으로 표시하고 0%로 대신하지 마세요.

03 / 연동

최소한의 연동 예시.

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;
  // 원본 링크를 표시하고 제3자 데이터 출처 표기를 유지하세요.
}
수집 새로고침 API는 별도로 인증합니다. 프런트엔드가 수집 키를 보유할 필요는 없습니다.현재 서비스 상태 보기 ↗
04 / 호환성

기존 호출과 호환됩니다.

기존 API도 계속 데이터를 제공합니다. 새 연동에는 버전이 지정된 v1 API를 권장합니다.