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 | 20 | 데이터셋 매니페스트: 카탈로그, 샘플 미리보기, 계보(lineage) 사용 현황 및 수집(ingest). |
| monitoring | 5 | 운영 지표, 정답(ground-truth) 성능 및 특징 분포 드리프트, 그리고 현장 GT 피드백. |
| drift | 7 | 드리프트 점수, 정책, 측정값 기록(CT 트리거) 및 PSI/KS 시계열. |
| alerts | 15 | 알림, 확인(ack)/해결(resolve), 규칙, 알림 채널 및 Alertmanager 수집. |
| edge | 33 | 엣지 플릿 관리, 디바이스 토큰 및 디바이스 인증 기반 자가 등록/하트비트. |
| mlflow | 4 | 테넌트별 MLflow 액세스 토큰: 발급, 목록 조회 및 폐기. 이 토큰은 MLflow 클라이언트가 격리되는 테넌트 워크스페이스를 고정합니다. 내장 MLflow 트래킹 서버 자체는 /mlflow 에 마운트되어 있으며, 그 진입점만 여기에 문서화되어 있습니다. 하위 REST API 는 업스트림 MLflow 스펙과 동일합니다. |
| registry | 14 | 앱 내장 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 |