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-After429·503 일 때 다시 보내기까지 기다릴 초

오류

오류 본문은 {"detail": "…"}입니다(422 는 detail이 위치·메시지 목록).

코드뜻
400API 키를 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(초)

엔드포인트