진단 결과
회차의 위험 구간 페이지 조회(기본 정렬: 심각도 높은 순 → priorityRank). 진행 중 회차도 끝난 분석의 위험 구간은 보인다(순위 없이).
GET/api/diagnoses/{diagnosisId}/findings
캡처 이미지 · 픽셀 크기는 GET /api/screen-results/{screenResultId}(captureImage · captureWidth · captureHeight)
- Scope
results:read - Since
1.0.0 - Success
200 - Demo tokenAllowed
id findings.list
Path parameters
GetFindingPaginationRequestPath
diagnosisIdstringrequired
Query
쿼리의 배열은 콤마로 이어 보낸다(status=A,B)
GetFindingPaginationRequestParams
limit 최대 10000
offsetnumberoptional시작 오프셋
limitnumberoptional조회 개수
sortstringoptional정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식
screenResultIdstringoptional화면 결과 하나만(형식이 UUID 가 아니면 400)
criterionAbleflowCriterion[]optional콤마 구분
severityAbleflowSeverity[]optionalAbleFlow - 위험 구간 심각도(화면 표기 높음 · 보통 · 낮음)
Response 200
GetFindingPaginationResponse
countnumberrequired전체 개수
prevstringrequirednull이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null
nextstringrequirednull다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null
- GetFindingPaginationResponseItem[]required
조회 결과
idstringrequiredscreenResultIdstringrequiredfingerprintstringrequired화면 id + 뷰포트 + 기준 + 요소 단서의 SHA-256(전후 비교)
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').
AbleFlow - 위험 구간 심각도(화면 표기 높음 · 보통 · 낮음)
titlestringrequired한 줄 제목(예: "글자 대비가 낮습니다(2.32:1)"). 규칙 제목은 한국어 원문(titleKey 로 옮긴다), AI 판단 제목은 요청 언어(?locale=) 번역이 있으면 그 글
titleKeystringoptional규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다
- AbleflowFindingMessageArgsoptional
문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)
- AbleflowRegionoptional
캡처 이미지 대비 0~1 비율. 규칙 계산은 늘 채우고, 영역을 못 정한 판단 결과면 빠진다
elementHintstringoptional요소 단서(셀렉터 · 역할 · 글자). 이미지 화면이면 추정. AI 판단이 쓴 단서는 요청 언어(?locale=) 번역이 있으면 그 글(화면 속 글자 · 셀렉터는 그대로 둔다), 규칙 단서는 저장된 값 그대로. 회차 사이 같은 위험 구간으로 묶는 일(fingerprint · groupKey)은 서버가 저장된 한국어 원문으로 한다
elementHintKeystringoptional규칙이 만든 고정 단서의 표시용 키(웹 메시지 키). 지금은 firstScreen("첫 화면", 첫 화면 정보 밀도)뿐. 셀렉터 · AI 단서는 빠진다 — 그때는 elementHint 를 그대로 보인다
- AbleflowEvidenceoptional
근거 수치(엔진은 위험 구간마다 하나)
priorityRanknumberoptional이 위험 구간이 속한 개선 우선순위 묶음의 순위(1부터). 끝난 회차만(진행 중이면 없음)
- object[]required
같은 묶음 키(groupKey)의 위험 구간이 있는 다른 분석(화면 순서 · 뷰포트 순)
impactstringoptional영향 설명 한 줄 · 고치는 품(기준별 고치는 방법에서 읽는다. 고정표가 없으면 빠진다. impact 는 요청 언어 번역이 있으면 그 글)
effortAbleflowEffortoptionalEASYMEDIUMHARD
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 고치는 데 드는 품(화면 표기 쉬움 · 보통 · 손이 많이 감)
- AbleflowGuideoptional
전문가 고정표(expert)와 AI 제안(ai, AI 위험 구간에 제안이 있을 때만)
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(초) |