API 레퍼런스 · 사실 조회
기준일의 사실
GET
https://api.neta-ai.com/fact-check/v1/facts기준일의 공개 사실을 조회합니다. post(직위) · person(사람) · org(기관·정당·기업·행정구역) · event(사건) 중 하나를 as_of 와 함께 보냅니다.
이름이 여러 개체에 맞으면 409와 candidates 가 옵니다. 그중 id 로 다시 물어 주세요. 날짜는 earliest·latest 쌍이고, 기간은 끝 날짜를 포함하지 않습니다. 하루 건수에 세지 않습니다.
요청 머리
| 이름 | 타입 | 설명 |
|---|---|---|
X-API-Key필수 | string | API 키. URL 쿼리·쿠키로는 받지 않습니다 |
쿼리 매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
post | string | 직위 → 기준일 보유자(incumbents · uncertain). id 또는 이름(옛 이름 포함) |
person | string | 사람 → 기준일 상태(held · uncertain · suspended · elect · former · deceased). event 와 같이 주면 그 사람의 사건 |
org | string | 기관·정당·기업·행정구역 → 기준일 공식 명칭. event 와 같이 주면 그 기관의 사건 |
event | string | 사건 유형(et-…) 또는 사건 id → 사건 날짜(events) |
as_of | string(YYYY-MM-DD) | 기준일. 비우면 오늘 |
include_candidates | boolean | 공식 확정 전 후보 기록(status: candidate)도 포함 |
응답
200질문에 따라 incumbents · held · official_name · events 등
| 이름 | 타입 | 설명 |
|---|---|---|
query | string | post · person · org · event |
…[].status · verified | string · boolean | confirmed·candidate, 공식 출처로 확정됐는지 |
…[].sources[] | array | title · url · tier · published_on |
graph_updated | string | 자료의 마지막 갱신 시각 |
| 응답 머리 | 뜻 |
|---|---|
X-Daily-Limit | 하루 상한 |
X-Daily-Remaining | 오늘 남은 건수 |
오류
| 코드 | 뜻 |
|---|---|
| 404 | 맞는 개체가 없음 |
| 409 | 이름이 여러 개체에 맞음. candidates 의 id 로 다시 |
| 401 | 키가 없거나 틀림(폐기한 키 포함) |
| 422 | 요청 형식 오류(필드·길이·매개변수 조합). detail 에 위치 |
| 429 | 하루 한도(1,000건) 또는 분당 한도(30) 초과. Retry-After(초) |
| 503 | 일시적으로 쓸 수 없음. Retry-After(초) |