API 레퍼런스
개요 · 인증 · 오류
모든 엔드포인트가 같은 기본 주소·인증·오류 형식을 씁니다. 엔드포인트별 요청·응답은 왼쪽 목록에서 고르세요.
기본 주소
https://api.neta-ai.com/fact-check/v1
요청·응답 모두 JSON(UTF-8)입니다. 스트림(/check/stream)만 text/event-stream입니다.
인증
키 발급(POST /keys)을 뺀 모든 경로에 X-API-Key: <키> 머리가 필요합니다. URL 쿼리·쿠키로는 받지 않습니다(넣으면 400). 키는 키 받기에서 로그인 없이 받습니다.
키를 브라우저 코드에 넣지 마세요
키는 서버에서만 쓰세요. 웹 페이지 스크립트에 넣으면 누구나 꺼내 당신의 하루 한도를 쓸 수 있습니다. 새었다고 생각되면 바로 폐기하세요.
응답 머리
| 머리 | 뜻 |
|---|---|
X-Daily-Limit | 이 키의 하루 상한(1,000) |
X-Daily-Remaining | 오늘 남은 건수 |
X-RateLimit-Limit · X-RateLimit-Remaining | 분당 한도와 이번 창에 남은 수(있을 때) |
Retry-After | 429·503 일 때 다시 보내기까지 기다릴 초 |
오류
오류 본문은 {"detail": "…"}입니다(422 는 detail이 위치·메시지 목록).
| 코드 | 뜻 |
|---|---|
| 400 | API 키를 URL 에 넣음. 키는 X-API-Key 머리로만 |
| 401 | 키가 없거나 틀림(폐기한 키 포함) |
| 403 | 이 키로 쓸 수 없는 경로 |
| 404 | 작업·개체가 없음 |
| 409 | 이름이 여러 개체에 맞음. candidates 의 id 로 다시 |
| 413 | 너무 긴 초안(공개 키: /check·/classify 6,000자, /check/stream 20,000자). 세지 않음 |
| 422 | 요청 형식 오류. detail 에 위치 |
| 429 | 하루 한도·분당 한도·키 발급 한도 초과. Retry-After(초) |
| 500 | 처리 중 오류. request_id 와 함께 문의 |
| 503 | 일시적으로 쓸 수 없음. Retry-After(초) |
엔드포인트
키
확인