자료

API 변경 내역

v1.0 — 2026-04-10

API 문서 최초 공개.

V1 LLM API

  • GET /v1/graph/search/ — 제목으로 노드 검색
  • GET /v1/graph/nodes/<id>/ — 노드 상세 정보 조회
  • GET /v1/graph/content/<id>/ — 페이지 콘텐츠 조회(마크다운)
  • GET /v1/graph/neighbors/<id>/ — BFS 방식으로 인접 노드 탐색
  • POST /v1/graph/traverse/ — 노드 간 최단 경로
  • GET /v1/ — API 자체를 설명하는 명세(인증 불필요)

그래프 API

  • GET /api/notion-graph/ — 전체 그래프 데이터(노드 + 엣지)

검색 API

  • GET /api/search/ — 전문 검색(BM25)
  • GET /api/search/suggest/ — 자동 완성
  • GET /api/search/semantic/ — 벡터 유사도 검색
  • GET /api/search/hybrid/ — BM25 + 벡터 검색
  • GET /api/search/similar/<id>/ — 유사한 노드 찾기
  • GET /api/search/content/<id>/ — 페이지 콘텐츠

인증

  • V1 API 접근용 서비스 토큰(ivg_*)
  • 사용자 API 접근용 노션 OAuth 기반 JWT

공개 엔드포인트

  • GET /api/stats/public/ — 플랫폼 통계
  • GET /api/health/ — 상태 확인