진단 결과
회차의 화면별 결과 전체(페이지 없음, 한 회차 분석 수가 한도 안이라)
GET/api/diagnoses/{diagnosisId}/screen-results/list
- Scope
results:read - Since
1.0.0 - Success
200 - Demo tokenAllowed
id screenResults.list
Path parameters
GetScreenResultsRequestPath
diagnosisIdstringrequired
Query
쿼리의 배열은 콤마로 이어 보낸다(status=A,B)
GetScreenResultsRequestParams
labelIdsstring[]optional레이블 범위(콤마, OR. 지금 화면에 붙은 레이블 기준)
viewportAbleflowViewportoptionalPCMOBILE
AbleFlow - 분석 뷰포트(진단 기본값). 화면은 BOTH 까지
statusAbleflowScreenResultStatus[]optional콤마 구분
sortstringoptionaluxRiskScore:DESC(기본, 점수 없는 분석은 뒤) · priority:ASC(프로젝트 화면 순서)
Response 200
GetScreenResultsResponse
idstringrequiredscreenIdstringrequired화면이 지워졌어도 남는다(screenDeleted)
screenNamestringrequired회차 시점의 이름 · 주소
urlstringoptionalsourceAbleflowScreenSourcerequiredURLIMAGEEXTENSION
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 화면을 넣은 방식(구분 칸). EXTENSION 은 확장 프로그램(P1, 만드는 API 없음)
screenDeletedbooleanrequired- AbleflowLabelRef[]required
지금 화면에 붙은 레이블(공통 먼저, 이름순). 지워진 화면은 []
idstringrequirednamestringrequiredcolorAbleflowLabelColorrequiredGRAYBLUETEALGREENAMBERREDPINKVIOLET
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 레이블 색(다른 enum 처럼 대문자)
scopeAbleflowLabelScoperequiredWORKSPACEPROJECT
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 레이블 범위: 공통(워크스페이스) · 프로젝트 전용
viewportAbleflowViewportrequiredPCMOBILE
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 분석 뷰포트(진단 기본값). 화면은 BOTH 까지
statusAbleflowScreenResultStatusrequiredQUEUEDCAPTURINGEXTRACTINGANALYZINGSCORINGCOMPLETEDFAILED
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 분석 하나의 단계(IMAGE 화면은 EXTRACTING 을 건너뛴다)
analysisPrecisionAbleflowAnalysisPrecisionrequiredDOMPIXEL
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 분석 정확도: URL · 확장 프로그램은 요소 정보(DOM), 이미지는 픽셀(PIXEL)
- FileInfoResponseoptional
전체 페이지 캡처(공용 응답 주입기, "ScreenResult_{id}" · "captureImage"). 이미지 화면 · 저장 못 한 캡처는 없음
objectKeystringrequired파일 object key
fileNamestringrequired파일명
getUrlstringrequired파일 다운로드 URL
altstringoptional대체 텍스트(요청 언어로 저장된 것이 있을 때만)
createdAtstringoptional올린 시각(응답에서는 대개 빠진다 — 파일 응답 변환이 비운다)
- AbleflowScoreSetoptional
COMPLETED 만
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
findingCountnumberrequired- AbleflowCriterionNote[]optional
COMPLETED 만, 없으면 없음. 빠진 기준 · 일부만 본 기준 · 문제 없음 답
criterionAbleflowCriterionrequiredCOLOR_DEPENDENCYLOW_CONTRASTINFORMATION_DENSITYLAYOUT_COMPLEXITYSTATUS_COMMUNICATION
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 진단 기준
reasonAbleflowCriterionNoteReasonrequiredAI_DISABLEDTIMEOUTCALL_FAILEDFORMAT_ERRORTRUNCATEDMISSING_IN_REPLYIMAGE_UNREADABLEIMAGE_TOO_LARGEBUDGET_EXCEEDEDTILE_LIMITTILE_FAILEDEMPTY_REPLY
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 기준 평가 메모 이유. 앞 9개는 점수에서 빠짐(unevaluated), TILE_LIMIT · TILE_FAILED 는 일부만 평가, EMPTY_REPLY 는 평가함(0점 · 확인 권장)
unevaluatedbooleanrequired
previousUxRiskScorenumberoptional지난 끝난 회차의 같은 화면 · 뷰포트 위험도
failureReasonAbleflowFailureReasonoptionalNOT_FOUNDTIMEOUTLOGIN_REQUIREDBLOCKEDUNKNOWN
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 분석 실패 이유
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(초) |