REST API
서버 OpenAPI 스펙에서 자동 생성한 엔드포인트 목록
모든 엔드포인트 목록. 서버의 OpenAPI 스펙에서 자동 생성했으며, 설명에는 서버 코드의 요약 문장과 필요 권한만 포함.
자세한 동작은 실행 중인 서버의 /docs(Swagger UI)와 /openapi.json 에서 확인.
- 인증: 브라우저는
/auth/cookie/login쿠키 세션, 스크립트는/auth/jwt/login으로 발급받은 Bearer 토큰 사용. - 테넌트:
/api/v1/*요청에는X-Tenant: <테넌트 코드>헤더(또는?tenant=) 지정. - 권한: 각 작업에 필요한 역할 권한은 역할과 권한 참고.
- 실제 호출 예시는 연동 가이드 참고.
| 묶음 | 엔드포인트 | 설명 |
|---|---|---|
| meta | 3 | Liveness, readiness 및 Prometheus 지표. 공개이며 인증이 필요하지 않음. |
| auth | 9 | 회원가입, JWT/쿠키 로그인 및 로그아웃, 비밀번호 재설정, 이메일 인증 및 GitHub OAuth. |
| users | 6 | 현재 사용자 프로필(/users/me): 조회 및 본인 정보 수정. |
| tenants | 10 | 테넌트 디렉터리 및 전환, 그리고 전역 관리자의 테넌트 프로비저닝. |
| dashboard | 2 | 홈 화면을 구성하는 집계 KPI 카드와 fan-in 요약. |
| experiments | 12 | MLflow 실험, 실행(run), 실행 비교, 지표 시계열 및 실행 등록. |
| models | 12 | 모델 레지스트리: 스테이지 매트릭스, 버전 이력, 일대일 비교 및 프로덕션 승격 요청. |
| approvals | 4 | 프로덕션 승격을 위한 승인 워크플로: 목록 조회, 상세 확인, 승인 또는 반려. |
| deployments | 6 | 대상 환경으로의 배포 롤아웃, 단계별 로그 및 수동 롤백. |
| pipelines | 8 | K8s Job 파이프라인(train/register/deploy/CT): 실행, 그래프, 로그, 트리거/재실행/중단. |
| datasets | 23 | 데이터셋 매니페스트: 카탈로그, 샘플 미리보기, 계보(lineage) 사용 현황 및 수집(ingest). |
| monitoring | 5 | 운영 지표, 정답(ground-truth) 성능 및 특징 분포 드리프트, 그리고 현장 GT 피드백. |
| drift | 7 | 드리프트 점수, 정책, 측정값 기록(CT 트리거) 및 PSI/KS 시계열. |
| alerts | 15 | 알림, 확인(ack)/해결(resolve), 규칙, 알림 채널 및 Alertmanager 수집. |
| edge | 40 | 엣지 플릿 관리, 디바이스 토큰 및 디바이스 인증 기반 자가 등록/하트비트. |
| collected | 8 | 수집 데이터: 테넌트의 엣지가 모은 파일·레코드·추론 결과를 장비를 가로질러 조회. 파일은 업로드 때 dataset_id 를 주지 않은 것이며 데이터셋과 별개로 보관됨. 레코드와 추론 결과는 보존 기간 뒤 지워지는 조회 창. 사용자 세션 인증이며 디바이스 토큰으로는 부를 수 없음. |
| mlflow | 4 | 테넌트별 MLflow 액세스 토큰: 발급, 목록 조회 및 폐기. 이 토큰은 MLflow 클라이언트가 격리되는 테넌트 워크스페이스 고정. 내장 MLflow 트래킹 서버 자체는 /mlflow 에 마운트되어 있으며, 그 진입점만 여기에 문서화되어 있음. 하위 REST API 는 업스트림 MLflow 스펙과 동일. |
| registry | 16 | 앱 내장 OCI 컨테이너 레지스트리. /api/v1/registry/tokens 로 docker 로그인용 PAT 를 관리하고, 레지스트리 자체는 호스트 루트 /v2 에 있음. /v2/ 진입점만 여기에 문서화되어 있으며, 하위 경로는 OCI Distribution Spec 을 그대로 따름. |
| stream | 5 | 실시간 알림 및 배포 진행 상황 업데이트를 위한 Server-Sent Event 스트림. |
| settings | 8 | 전역 관리자 백오피스: 사용자 및 역할, 통합 상태 및 감사 로그. |
| dataset-syncs | 9 | |
| external-sources | 8 | |
| gpu | 1 | |
| images | 17 | |
| kubernetes | 20 | |
| notifications | 6 | |
| observability | 6 | |
| serving | 15 | |
| system | 32 | |
| training | 51 |