상태 요약, 예측, 신호, 기록, 출처 메타데이터를 제공합니다. 앱의 첫 번째 요청으로 적합합니다.
API 목록
용도에 맞는 데이터를 선택하여 같은 상위 출처의 공지를 중복 수집하지 않도록 하세요.
공개 게시물에서 초기화, 계획, 힌트, 사용 한도 소식을 필터링하고 분류와 확인 상태를 보존합니다.
수집된 초기화 공지입니다. 완료 공지가 있어도 개인 계정의 사용 한도가 확인되었다는 뜻은 아닙니다.
/api/v1/tibo 수집된 모든 유효 게시물로, 원문, 게시 시간, 링크, 수집 모드를 포함합니다.
/api/health 서비스와 데이터 출처의 사용 가능 여부를 확인합니다. 배포 상태 점검 및 예약 작업에서 호출할 수 있습니다.
원문 발언과 수집 출처를 영구 저장하며 페이지별 조회를 지원합니다. 최초 수집 전 기록의 완전성은 보장하지 않습니다.
과거 기준값, 실험적 조정과 발언별 영향을 반환합니다. 규칙은 보정되지 않았으며 기존 예측 API는 상위 출처 기준값을 유지합니다.
/api/v1/overviewprobability_model → baseline / adjusted / factors / model_version / evaluated_attibo_history → total / persistent / complete_history필터링 및 페이지 구분
signals, resets, tibo 목록 API에 적용됩니다.
| 매개변수 | 설명 |
|---|---|
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로 직접 수집과 제3자 사본을 구분합니다. |
예측 필드 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;
// 원본 링크를 표시하고 제3자 데이터 출처 표기를 유지하세요.
}기존 호출과 호환됩니다.
기존 API도 계속 데이터를 제공합니다. 새 연동에는 버전이 지정된 v1 API를 권장합니다.