AbleFlowDocs

진단 결과

회차의 위험 구간 페이지 조회(기본 정렬: 심각도 높은 순 → priorityRank). 진행 중 회차도 끝난 분석의 위험 구간은 보인다(순위 없이).

GET/api/diagnoses/{diagnosisId}/findings

캡처 이미지 · 픽셀 크기는 GET /api/screen-results/{screenResultId}(captureImage · captureWidth · captureHeight)

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

    AbleFlow - 위험 구간 심각도(화면 표기 높음 · 보통 · 낮음)

Response 200

GetFindingPaginationResponse

  • countnumberrequired

    전체 개수

  • prevstringrequirednull

    이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null

  • nextstringrequirednull

    다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null

  • GetFindingPaginationResponseItem[]required

    조회 결과

    • idstringrequired
    • screenResultIdstringrequired
    • fingerprintstringrequired

      화면 id + 뷰포트 + 기준 + 요소 단서의 SHA-256(전후 비교)

    • 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').

      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 는 요청 언어 번역이 있으면 그 글)

    • effortAbleflowEffortoptional
      • EASY
      • MEDIUM
      • HARD

      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
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(초)