진단
회차 요약. 진행 중이면 분석 진행 화면, 끝나면 결과 대시보드가 쓴다
GET/api/diagnoses/{diagnosisId}
- Scope
diagnoses:read - Since
1.0.0 - Success
200 - Demo tokenAllowed
- Personal dataThe response contains personal data
id diagnoses.get
Path parameters
GetDiagnosisRequestPath
diagnosisIdstringrequired
Response 200
GetDiagnosisResponse
idstringrequiredprojectIdstringrequiredseqnumberrequiredtriggerAbleflowDiagnosisTriggerrequiredMANUALFREE_TRIALSCHEDULEDPRE_DEPLOY
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 회차를 만든 계기. 사용자 실행은 MANUAL
statusAbleflowDiagnosisStatusrequiredQUEUEDRUNNINGCOMPLETEDPARTIALFAILEDCANCELED
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 회차 상태. 진행 중(QUEUED · RUNNING)은 프로젝트에 하나
criteriaAbleflowCriterion[]requiredAbleFlow - 진단 기준
viewportsAbleflowViewport[]requiredAbleFlow - 분석 뷰포트(진단 기본값). 화면은 BOTH 까지
scoringVersionstringrequired산식 버전(지금 "2026.11-r2"). 지난 회차와 다르면 비교에 안내
screenCountnumberrequiredanalysisCountnumberrequiredcompletedCountnumberrequiredfailedCountnumberrequiredfindingCountnumberrequired- AbleflowScoreSetoptional
끝난 회차만
uxRiskScorenumberrequiredcognitionScorenumberrequiredgradeAbleflowGraderequiredSAFECAUTIONRISKCRITICAL
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 대표 위험도 구간: 0~29 SAFE · 30~49 CAUTION · 50~69 RISK · 70~100 CRITICAL
- object[]required
- objectoptional
바로 앞 끝난 회차(없으면 빠진다)
idstringrequiredseqnumberrequired- AbleflowScoreSetrequired
앞 회차는 끝난 회차(COMPLETED · PARTIAL)만이라 점수가 늘 있다
scoringVersionstringrequired
failureReasonstringoptionalFAILED 일 때 한 줄 이유(한국어 원문)
failureCodestringoptional회차 실패 문구 키(예: allAnalysesFailed, 키 목록은 AbleflowFailureMessageArgs 설명). 키를 쓰기 전 행은 빠진다 — 그때는 failureReason 을 그대로 보인다
- AbleflowMemberRefrequired
AbleFlow - 사람 표시. 이름 · 이메일은 계정 DB 에서 채운다(찾지 못하면 name 없음). 공개 API 토큰에 members:read 가 없으면 email 이 빠진다
memberIdstringrequirednamestringoptionalemailstringoptional
createdAtstringrequiredstartedAtstringoptionalfinishedAtstringoptional
Errors
9 errors common to every public API
| Status | Code | When |
|---|---|---|
| 400 | UNSUPPORTED_API_VERSION | AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported } |
| 401 | UNAUTHORIZED | Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다 |
| 401 | INVALID_TOKEN | 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함) |
| 401 | TOKEN_EXPIRED | 토큰이 만료됐다 |
| 403 | INSUFFICIENT_SCOPE | 토큰 범위가 모자란다. detail { required } |
| 403 | DEMO_READ_ONLY | 데모 토큰은 GET · HEAD 만 부를 수 있다 |
| 403 | PLAN_FEATURE_REQUIRED | 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? } |
| 404 | RESOURCE_NOT_FOUND | 자원이 없거나 토큰이 묶인 워크스페이스 밖이다 |
| 429 | API_RATE_LIMITED | 호출 한도를 넘었다. Retry-After(초) |