API 레퍼런스

내부 API 레퍼런스

이 엔드포인트는 IVGraph 웹 애플리케이션을 구동해요. 별도로 명시된 경우를 제외하면 JWT 인증이 필요해요. 이 문서는 참고용이며, 통합 용도로는 V1 LLM API를 우선 사용해 주세요.

사용자 및 프로필

메서드 엔드포인트 설명
GET /api/auth/me/ 현재 사용자 정보 (id, email, username, is_staff)
GET /api/auth/validate/ JWT 토큰 유효성 확인
POST /api/auth/refresh/ 액세스 토큰 갱신
POST /api/auth/logout/ 리프레시 토큰을 차단 목록에 추가
GET /api/user/me/ 사용자 프로필 상세 정보
PUT /api/user/me/ 사용자 프로필 업데이트
GET /api/user/profile/ 사용자 프로필 보기

추천인 시스템

메서드 엔드포인트 설명
GET /api/referral/my-code/ 사용자의 추천인 코드 조회
POST /api/referral/apply/ 추천인 코드 적용
GET /api/referral/stats/ 추천인 통계

노션 OAuth

메서드 엔드포인트 설명
GET /api/integrations/auth/notion/ 노션 OAuth 인증 절차 시작 (노션으로 리디렉션)
GET /api/integrations/auth/notion/callback OAuth 콜백 (코드를 토큰으로 교환)
GET /api/integrations/auth/notion/status OAuth 연결 상태 확인
POST /api/integrations/auth/logout/ 노션 통합 연결 해제
POST /api/integrations/auth/delete-account/ 사용자 계정 및 모든 데이터 삭제

워크스페이스 관리

메서드 엔드포인트 설명
GET /api/integrations/workspaces/ 사용자의 노션 워크스페이스 목록 조회
GET /api/integrations/workspaces/<id>/ 워크스페이스 상세 정보
POST /api/integrations/workspaces/<id>/primary/ 워크스페이스를 기본 워크스페이스로 설정

동기화 관리

메서드 엔드포인트 설명
GET /api/integrations/status/ 통합 및 동기화 상태
GET /api/integrations/notion/permissions/ Notion API 권한 확인
POST /api/integrations/airbyte/setup/ 워크스페이스의 Airbyte 연결 설정
GET /api/integrations/airbyte/setup/progress/ 설정 진행 상황
POST /api/integrations/airbyte/sync/ 증분 동기화 시작
POST /api/integrations/airbyte/sync/cancel/ 진행 중인 동기화 취소
GET /api/integrations/airbyte/sync/progress/ 동기화 진행 상황 (이 엔드포인트를 폴링)
POST /api/integrations/airbyte/full-refresh/ 전체 데이터 새로고침 (모든 데이터를 다시 동기화)

결제 (Stripe)

메서드 엔드포인트 설명
GET /api/billing/plans/ 이용 가능한 구독 요금제 목록 조회
POST /api/billing/create-checkout/ Stripe 결제 세션 생성
POST /api/billing/confirm-checkout/ 결제 완료 확인
GET /api/billing/subscription/ 사용자의 구독 상세 정보 조회
POST /api/billing/portal/ Stripe 고객 포털 링크 생성

스타일 규칙 및 그래프 설정

메서드 엔드포인트 설명
GET /api/databases/ 규칙 적용 대상 데이터베이스 목록 조회
GET/PUT /api/graph-settings/ 전역 그래프 설정 (색상, 토글)
GET/POST /api/advanced-rules/ 고급 스타일 규칙 목록 조회/생성
GET/PUT/DELETE /api/advanced-rules/<id>/ 개별 규칙 관리
POST /api/advanced-rules/reorder/ 우선순위에 따라 규칙 순서 변경
GET/POST /api/style-presets/ 스타일 프리셋 목록 조회/생성
GET/PUT/DELETE /api/style-presets/<id>/ 개별 프리셋 관리
POST /api/style-presets/<id>/activate/ 프리셋 활성화
POST /api/style-presets/<id>/duplicate/ 프리셋 복제

서비스 토큰 관리

메서드 엔드포인트 설명
GET /api/tokens/ 사용자의 서비스 토큰 목록 조회
POST /api/tokens/ 새 서비스 토큰 생성
DELETE /api/tokens/<id>/ 토큰 영구 폐기

토큰 생성에 대한 자세한 내용은 인증 문서를 참고해 주세요.

기타

메서드 엔드포인트 인증 설명
GET /api/connections/ JWT 사용자의 Airbyte 연결 목록 조회
GET /api/integrations/ JWT 통합 개요
GET /api/activity/ JWT 최근 활동 로그
GET /api/health/ 없음 상태 확인
GET /api/health/celery/ 없음 Celery 워커 상태
GET /api/stats/public/ 없음 플랫폼 통계 (24h 캐시)
POST /api/errors/report/ 없음 프런트엔드 오류 보고