AbleFlowDocs

진단 결과

개선 우선순위: 위험 구간을 같은 문제(groupKey)로 묶은 개선 항목(페이지 없음, rank 순). 결과 대시보드 "먼저 고칠 것"은 limit 3.

GET/api/diagnoses/{diagnosisId}/priorities/list

저장하지 않고 읽을 때 계산한다. 끝난(COMPLETED · PARTIAL) 회차만

  • Scoperesults:read
  • Since1.0.0
  • Success200
  • 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

  • ranknumberrequired

    1부터(회차 전체 기준. labelIds 로 걸러도 순위는 그대로)

  • groupKeystringrequired

    묶음 키 = SHA-256(기준 | 요소 단서). 화면 · 뷰포트를 넣지 않아 여러 화면의 같은 문제가 한 줄이 되고, 회차가 바뀌어도 같은 문제면 같다

  • titlestringrequired

    묶음에서 가장 심각한 위험 구간의 제목

  • titleKeystringoptional

    규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다

  • AbleflowFindingMessageArgsoptional

    문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)

    • ratiostringoptional

      대비(소수 둘째 자리 글자, 예: "3.88"). textContrastLow

    • fontSizenumberoptional

      글자 크기(px) · 굵기. textContrastLowNote

    • fontWeightnumberoptional
    • textBlocksnumberoptional

      첫 화면 글 덩어리 수 · 누를 수 있는 요소 수. firstViewDenseNote

    • interactiveElementsnumberoptional
  • 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 - 진단 기준

  • severityAbleflowSeverityrequired
    • HIGH
    • MEDIUM
    • LOW

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

    묶은 위험 구간 중 가장 높은 것

  • impactnumberrequired

    0~100 = round(영향 분석 위험도 합 ÷ (100 × 회차 분석 수) × 100)

  • findingIdsstring[]required
  • elementHintstringoptional

    대표 위험 구간(심각도 높은 순 → 먼저 생긴 순)의 요소 단서. 화면이 같은 제목 · 같은 값 줄을 묶어 펼칠 때 요소 이름으로 보인다. 없으면 빠진다

  • elementHintKeystringoptional

    elementHint 가 규칙의 고정 단서일 때 표시용 키(예: firstScreen). 셀렉터 · AI 단서는 빠진다

  • object[]required

    영향 화면(화면 순서 · 뷰포트 순)

    • screenResultIdstringrequired
    • screenNamestringrequired
    • viewportAbleflowViewportrequired
      • PC
      • MOBILE

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

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

  • effortAbleflowEffortoptional
    • EASY
    • MEDIUM
    • HARD

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

    아래 넷은 기준별 고치는 방법(운영 콘솔 고정표)에서 읽는다. 고정표가 없으면 빠진다

  • componentAbleflowGuideComponentoptional
    • ERROR_MESSAGE
    • BUTTON
    • INPUT
    • CARD_TABLE
    • TEXT
    • TAB_STATUS

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

    AbleFlow - 고칠 부품 종류(오류 메시지 · 버튼 · 입력 칸 · 카드, 표 · 글 영역 · 탭, 상태 표시)

  • evidencestringoptional

    근거 한 줄 · 고치는 방법

  • fixstringoptional
  • objectoptional

    이미 담은 열린(DONE · DISMISSED 가 아닌) 과제

    • idstringrequired
    • statusAbleflowIssueStatusrequired
      • TODO
      • IN_PROGRESS
      • IN_REVIEW
      • DONE
      • ON_HOLD
      • DISMISSED

      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

Errors of this endpoint
StatusCodeWhen
409DIAGNOSIS_NOT_FINISHED끝나지 않은 회차
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(초)