REST API
facts를 프로그램에서 직접 조회하는 읽기 전용 공개 API입니다.
- 인증 없음. IP당 분당 60회 제한.
- 모든 시간은 UTC, 응답은 JSON.
- 정본 명세는 API 자신이 서술합니다: https://ratatosk.io/v1 를 열면 전체 엔드포인트·파라미터·예시가 담긴 인덱스가 나옵니다.
엔드포인트
| 경로 | 용도 |
|---|---|
GET /v1 |
자기서술 인덱스 (이 API의 정본 문서) |
GET /v1/facts |
fact 증분 피드. project type severity since limit 필터 |
GET /v1/facts/by-entity |
역인덱스: 식별자 하나(CVE·CRD·플래그 등)를 건드린 모든 fact |
GET /v1/releases/{project}/{version} |
릴리스 하나의 리뷰 전체. include=raw로 원문 포함 |
예시
최근 critical facts 5건:
curl "https://ratatosk.io/v1/facts?severity=critical&limit=5"
특정 CVE를 다룬 fact 찾기:
curl "https://ratatosk.io/v1/facts/by-entity?name=CVE-2026-33186"
릴리스 하나를 원문과 함께:
curl "https://ratatosk.io/v1/releases/thanos/v0.42.0?include=raw"
증분 폴링
/v1/facts는 fact_id 오름차순이며 응답의 next_since를 다음 요청의
since로 넘기면 새 fact만 이어서 받습니다. 주기적으로 전체를 다시 받는
대신 이 커서를 쓰세요.
이용 조건
분석은 AI 생성물이며 보증 없이 제공됩니다. 원문 검증용 출처가 항상 함께 제공됩니다. 자세한 내용은 이용약관을 보세요.