AbleFlowDocs

진단 결과

두 회차 전후 비교. 같은 프로젝트의 끝난(COMPLETED · PARTIAL) 회차 아무 둘(회차 띠에서 기준 · 비교를 바꾼다, 순서 제한 없음).

GET/api/diagnoses/compare

위험도는 높을수록 위험이라 delta(target - base)가 음수면 좋아진 것이다

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

id diagnoses.compare

Query

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

GetDiagnosisCompareRequestParams

  • basestringrequired

    기준(앞) 회차 UUID

  • targetstringrequired

    비교(뒤) 회차 UUID

Response 200

GetDiagnosisCompareResponse

  • DiagnosisCompareSiderequired

    한 회차 쪽 요약(끝난 회차만)

    • idstringrequired
    • seqnumberrequired
    • finishedAtstringrequired
    • AbleflowScoreSetrequired

      AbleFlow - 점수 묶음. 위험도 0~100(높을수록 위험) · 이해도 = 100 - 위험도. criteria 는 평가한 기준만(AI 판단이 꺼져 있거나 답을 받지 못한 기준은 빠진다)

    • scoringVersionstringrequired
  • DiagnosisCompareSiderequired

    한 회차 쪽 요약(끝난 회차만)

    • idstringrequired
    • seqnumberrequired
    • finishedAtstringrequired
    • AbleflowScoreSetrequired

      AbleFlow - 점수 묶음. 위험도 0~100(높을수록 위험) · 이해도 = 100 - 위험도. criteria 는 평가한 기준만(AI 판단이 꺼져 있거나 답을 받지 못한 기준은 빠진다)

    • scoringVersionstringrequired
  • sameScoringVersionbooleanrequired

    산식 버전이 다르면 false(화면에 안내)

  • object[]required

    한쪽이라도 점수가 난 기준(기준 순서). 한쪽에만 있으면 그쪽 점수만 있고 delta 는 빠진다

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

    • baseScorenumberoptional
    • targetScorenumberoptional
    • deltanumberoptional
  • object[]required

    화면 · 뷰포트별(화면 순서 → 뷰포트). 위험도가 있는(COMPLETED) 분석끼리 견주고, 한쪽에만 있으면(다른 쪽이 없거나 실패) ADDED · REMOVED

    • screenIdstringrequired
    • screenNamestringrequired
    • viewportAbleflowViewportrequired
      • PC
      • MOBILE

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

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

    • changeenumrequired
      • IMPROVED
      • WORSENED
      • SAME
      • ADDED
      • REMOVED

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

    • baseScreenResultIdstringoptional
    • targetScreenResultIdstringoptional
    • baseUxRiskScorenumberoptional
    • targetUxRiskScorenumberoptional
    • FileInfoResponseoptional

      비교 슬라이더(캡처가 있을 때만)

    • FileInfoResponseoptional

      API 공통 - 파일 응답

    • baseFailedenumoptional
      • true

      그 회차에 분석이 있었지만 실패했다(ADDED · REMOVED 가 화면이 없던 것이 아님). 실패일 때만 true, 아니면 빠진다

    • targetFailedenumoptional
      • true
  • objectrequired

    양쪽 모두 COMPLETED 인 분석에서 양쪽 모두 평가한 기준의 위험 구간만 fingerprint 로 견준다

    • resolvednumberrequired
    • addednumberrequired
    • remainingnumberrequired
    • worsenednumberrequired

      남은 것 중 심각도가 올라간 것(악화)

    • object[]required

      fingerprint 별(ADDED → RESOLVED → REMAINING → 심각도 높은 순 → 화면)

Errors

Errors of this endpoint
StatusCodeWhen
400BAD_REQUESTbase · target 이 없거나 같거나 다른 프로젝트 회차
409DIAGNOSIS_NOT_FINISHED끝나지 않은 회차
403PLAN_FEATURE_REQUIRED요금제에 전후 비교가 없거나 체험이 끝났다(요금제로 막을 때). detail { target: COMPARE, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }
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(초)