진단 결과
개선 우선순위: 위험 구간을 같은 문제(groupKey)로 묶은 개선 항목(페이지 없음, rank 순). 결과 대시보드 "먼저 고칠 것"은 limit 3.
GET/api/diagnoses/{diagnosisId}/priorities/list
저장하지 않고 읽을 때 계산한다. 끝난(COMPLETED · PARTIAL) 회차만
- Scope
results:read - Since
1.0.0 - Success
200 - Demo tokenAllowed
- Personal dataThe response contains personal data
id priorities.list
Path parameters
GetPrioritiesRequestPath
diagnosisIdstringrequired
Query
쿼리의 배열은 콤마로 이어 보낸다(status=A,B)
GetPrioritiesRequestParams
limitnumberoptional위에서 몇 개(없으면 전부, 1~10000, 공통 목록 상한)
labelIdsstring[]optional레이블 범위(콤마 구분, OR). 영향 화면 중 하나라도 그 레이블이 붙은 묶음만
Response 200
GetPrioritiesResponse
ranknumberrequired1부터(회차 전체 기준. labelIds 로 걸러도 순위는 그대로)
groupKeystringrequired묶음 키 = SHA-256(기준 | 요소 단서). 화면 · 뷰포트를 넣지 않아 여러 화면의 같은 문제가 한 줄이 되고, 회차가 바뀌어도 같은 문제면 같다
titlestringrequired묶음에서 가장 심각한 위험 구간의 제목
titleKeystringoptional규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다
- AbleflowFindingMessageArgsoptional
문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)
ratiostringoptional대비(소수 둘째 자리 글자, 예: "3.88"). textContrastLow
fontSizenumberoptional글자 크기(px) · 굵기. textContrastLowNote
fontWeightnumberoptionaltextBlocksnumberoptional첫 화면 글 덩어리 수 · 누를 수 있는 요소 수. firstViewDenseNote
interactiveElementsnumberoptional
criterionAbleflowCriterionrequiredCOLOR_DEPENDENCYLOW_CONTRASTINFORMATION_DENSITYLAYOUT_COMPLEXITYSTATUS_COMMUNICATION
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 진단 기준
severityAbleflowSeverityrequiredHIGHMEDIUMLOW
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
묶은 위험 구간 중 가장 높은 것
impactnumberrequired0~100 = round(영향 분석 위험도 합 ÷ (100 × 회차 분석 수) × 100)
findingIdsstring[]requiredelementHintstringoptional대표 위험 구간(심각도 높은 순 → 먼저 생긴 순)의 요소 단서. 화면이 같은 제목 · 같은 값 줄을 묶어 펼칠 때 요소 이름으로 보인다. 없으면 빠진다
elementHintKeystringoptionalelementHint 가 규칙의 고정 단서일 때 표시용 키(예: firstScreen). 셀렉터 · AI 단서는 빠진다
- object[]required
영향 화면(화면 순서 · 뷰포트 순)
screenResultIdstringrequiredscreenNamestringrequiredviewportAbleflowViewportrequiredPCMOBILE
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 분석 뷰포트(진단 기본값). 화면은 BOTH 까지
effortAbleflowEffortoptionalEASYMEDIUMHARD
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
아래 넷은 기준별 고치는 방법(운영 콘솔 고정표)에서 읽는다. 고정표가 없으면 빠진다
componentAbleflowGuideComponentoptionalERROR_MESSAGEBUTTONINPUTCARD_TABLETEXTTAB_STATUS
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 고칠 부품 종류(오류 메시지 · 버튼 · 입력 칸 · 카드, 표 · 글 영역 · 탭, 상태 표시)
evidencestringoptional근거 한 줄 · 고치는 방법
fixstringoptional- objectoptional
이미 담은 열린(DONE · DISMISSED 가 아닌) 과제
idstringrequiredstatusAbleflowIssueStatusrequiredTODOIN_PROGRESSIN_REVIEWDONEON_HOLDDISMISSED
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 개선 과제 상태(화면 표기 할 일 · 진행 중 · 확인 대기 · 완료 · 보류 · 무시됨). DONE · DISMISSED 가 닫힌 과제(ON_HOLD 도 열린 과제). DISMISSED 는 다음 회차 확인 · 자동 다시 열기에서 빠진다
- AbleflowMemberRefoptional
AbleFlow - 사람 표시. 이름 · 이메일은 계정 DB 에서 채운다(찾지 못하면 name 없음). 공개 API 토큰에 members:read 가 없으면 email 이 빠진다
- AbleflowGuideoptional
전문가 고정표(expert)와 AI 제안(ai, 묶음의 대표 위험 구간에 AI 제안이 있을 때만)을 나눠 준다
- objectrequired
- objectoptional
Errors
| Status | Code | When |
|---|---|---|
| 409 | DIAGNOSIS_NOT_FINISHED | 끝나지 않은 회차 |
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(초) |