문서 · API 프리뷰

REST API 프리뷰

출시 준비용 공개 API 설계안입니다. 현재 데모는 앱 내부 /api/evaluations 라우트를 사용하며, 프로덕션 인증·SDK·호스팅 엔드포인트는 확정 전입니다.

# 인증 curl https://api.ganeum.nerddy.ai/v1/outcomes \ -H "Authorization: Bearer ganeum_preview_..." # SDK 사용 import { Ganeum } from "@ganeum/sdk" const client = new Ganeum({ apiKey: process.env.GANEUM_API_KEY }) const outcomes = await client.outcomes.list({ project_id: "p_2" })

GET · POST · PATCH

증거 산출물

GET/v1/outcomes산출물 목록 (페이지네이션, owner · project · status로 필터)

GET/v1/outcomes/:id산출물 단건 — 결정 · 블로커 · 학습 포함 전체 체인

POST/v1/outcomes산출물 생성 (대부분 필드는 신호에서 자동 채워짐)

PATCH/v1/outcomes/:id/review매니저 검토 (점수, 상태, 메모)

가늠 평가 환경

평가 샌드박스

POST/v1/sandbox/run프롬프트를 평가 샌드박스에서 실행하고 산출물 채점

GET/v1/sandbox/runs/:id실행 결과 — 루브릭 점수와 트라이앵귤레이션 근거 포함

역량 벡터

5축 역량

GET/v1/capability/:user_id사용자 역량 벡터 (5축, 0-100)

GET/v1/capability/team팀 히트맵 (평균 + 분산)

Daily · Weekly Synthesis

자동 합성 보고

GET/v1/reports/daily/:user_id사용자 Daily Synthesis (살핌 감지 신호 · 증거 산출물 포함)

GET/v1/reports/weekly/:project_id프로젝트 Weekly Synthesis (메트릭 진척 + 엮음 이력)

SDK + Postman 컬렉션

TypeScript · Python SDK와 Postman 컬렉션은 호스팅 API 공개 단계에서 제공합니다. 현재 페이지는 계약 설계안입니다.

시작하기