AbleFlowDocs

진단 결과

회차의 화면별 결과 전체(페이지 없음, 한 회차 분석 수가 한도 안이라)

GET/api/diagnoses/{diagnosisId}/screen-results/list

  • Scoperesults:read
  • Since1.0.0
  • Success200
  • Demo tokenAllowed

id screenResults.list

Path parameters

GetScreenResultsRequestPath

  • diagnosisIdstringrequired

Query

쿼리의 배열은 콤마로 이어 보낸다(status=A,B)

GetScreenResultsRequestParams

  • labelIdsstring[]optional

    레이블 범위(콤마, OR. 지금 화면에 붙은 레이블 기준)

  • viewportAbleflowViewportoptional
    • PC
    • MOBILE

    AbleFlow - 분석 뷰포트(진단 기본값). 화면은 BOTH 까지

  • statusAbleflowScreenResultStatus[]optional

    콤마 구분

  • sortstringoptional

    uxRiskScore:DESC(기본, 점수 없는 분석은 뒤) · priority:ASC(프로젝트 화면 순서)

Response 200

GetScreenResultsResponse

  • idstringrequired
  • screenIdstringrequired

    화면이 지워졌어도 남는다(screenDeleted)

  • screenNamestringrequired

    회차 시점의 이름 · 주소

  • urlstringoptional
  • sourceAbleflowScreenSourcerequired
    • URL
    • IMAGE
    • EXTENSION

    Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').

    AbleFlow - 화면을 넣은 방식(구분 칸). EXTENSION 은 확장 프로그램(P1, 만드는 API 없음)

  • screenDeletedbooleanrequired
  • AbleflowLabelRef[]required

    지금 화면에 붙은 레이블(공통 먼저, 이름순). 지워진 화면은 []

    • idstringrequired
    • namestringrequired
    • colorAbleflowLabelColorrequired
      • GRAY
      • BLUE
      • TEAL
      • GREEN
      • AMBER
      • RED
      • PINK
      • VIOLET

      Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').

      AbleFlow - 레이블 색(다른 enum 처럼 대문자)

    • scopeAbleflowLabelScoperequired
      • WORKSPACE
      • PROJECT

      Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').

      AbleFlow - 레이블 범위: 공통(워크스페이스) · 프로젝트 전용

  • viewportAbleflowViewportrequired
    • PC
    • MOBILE

    Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').

    AbleFlow - 분석 뷰포트(진단 기본값). 화면은 BOTH 까지

  • statusAbleflowScreenResultStatusrequired
    • QUEUED
    • CAPTURING
    • EXTRACTING
    • ANALYZING
    • SCORING
    • COMPLETED
    • FAILED

    Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').

    AbleFlow - 분석 하나의 단계(IMAGE 화면은 EXTRACTING 을 건너뛴다)

  • analysisPrecisionAbleflowAnalysisPrecisionrequired
    • DOM
    • PIXEL

    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 만

    • uxRiskScorenumberrequired
    • cognitionScorenumberrequired
    • gradeAbleflowGraderequired
      • SAFE
      • CAUTION
      • RISK
      • CRITICAL

      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 만, 없으면 없음. 빠진 기준 · 일부만 본 기준 · 문제 없음 답

    • criterionAbleflowCriterionrequired
      • COLOR_DEPENDENCY
      • LOW_CONTRAST
      • INFORMATION_DENSITY
      • LAYOUT_COMPLEXITY
      • STATUS_COMMUNICATION

      Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').

      AbleFlow - 진단 기준

    • reasonAbleflowCriterionNoteReasonrequired
      • AI_DISABLED
      • TIMEOUT
      • CALL_FAILED
      • FORMAT_ERROR
      • TRUNCATED
      • MISSING_IN_REPLY
      • IMAGE_UNREADABLE
      • IMAGE_TOO_LARGE
      • BUDGET_EXCEEDED
      • TILE_LIMIT
      • TILE_FAILED
      • EMPTY_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

    지난 끝난 회차의 같은 화면 · 뷰포트 위험도

  • failureReasonAbleflowFailureReasonoptional
    • NOT_FOUND
    • TIMEOUT
    • LOGIN_REQUIRED
    • BLOCKED
    • UNKNOWN

    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
Common to every public API
StatusCodeWhen
400UNSUPPORTED_API_VERSIONAbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }
401UNAUTHORIZEDAuthorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다
401INVALID_TOKEN토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)
401TOKEN_EXPIRED토큰이 만료됐다
403INSUFFICIENT_SCOPE토큰 범위가 모자란다. detail { required }
403DEMO_READ_ONLY데모 토큰은 GET · HEAD 만 부를 수 있다
403PLAN_FEATURE_REQUIRED워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }
404RESOURCE_NOT_FOUND자원이 없거나 토큰이 묶인 워크스페이스 밖이다
429API_RATE_LIMITED호출 한도를 넘었다. Retry-After(초)