AbleFlowDocs

개선 과제

과제 상세(최근 회차 위험 구간 스크린샷 · 담당 · 메모 · 기록)

GET/api/issues/{issueId}

  • Scopeissues:read
  • Since1.0.0
  • Success200
  • Demo tokenAllowed
  • Personal dataThe response contains personal data

id issues.get

Path parameters

GetIssueRequestPath

  • issueIdstringrequired

Response 200

GetIssueResponse

  • idstringrequired
  • seqnumberrequired

    워크스페이스 안 표시 번호

  • projectIdstringrequired
  • projectNamestringrequired
  • titlestringrequired

    과제 제목(만들 때 묶음 대표 위험 구간의 제목). 규칙 제목은 한국어 원문(titleKey 로 옮긴다), AI 판단 제목은 요청 언어(?locale=) 번역이 있으면 그 글 (만든 회차의 같은 묶음 · 같은 원문 제목 위험 구간의 번역, 그 회차가 지워졌으면 한국어 원문)

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

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

  • 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 이 빠진다

    • memberIdstringrequired
    • namestringoptional
    • emailstringoptional
  • screenCountnumberrequired

    영향 분석 수 · 묶은 위험 구간 수(그 프로젝트의 가장 최근 끝난 회차 기준, 그 회차에 없으면 0)

  • findingCountnumberrequired
  • elementHintstringoptional

    최근 끝난 회차에서 이 과제 묶음의 요소 단서(같은 제목 과제를 구분). 그 회차에 묶음이 없으면 빠진다

  • elementHintKeystringoptional

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

  • latestDiagnosisEvaluatedbooleanoptional

    그 최근 끝난 회차가 이 과제의 기준을 평가했는지(끝난 분석 중 하나라도 그 기준 점수를 냈는지). false 면 screenCount · findingCount 의 0 은 "고쳐짐"이 아니라 "이번 회차는 보지 않음"(기준 일부만 고른 진단 등). 끝난 회차가 없으면 없음

  • objectoptional

    만든 회차와 그때 우선순위 순위(회차가 지워졌으면 빠진다). finishedAt 은 그 회차를 실패만 다시 하는 중(재실행 중)에는 없음

    • diagnosisIdstringrequired
    • seqnumberrequired
    • finishedAtstringoptional
    • ranknumberoptional
  • objectoptional

    다음 회차 확인(무시됨을 뺀 모든 과제, 확인 전에는 없음). 같은 묶음 키가 사라지면 CONFIRMED, 남으면 REOPENED(열린 과제는 아직 남음). 완료 과제가 REOPENED 면 서버가 TODO 로 다시 연다(같은 묶음의 열린 과제가 있으면 결과만). at = 확인한 회차가 끝난 시각

    • diagnosisIdstringrequired
    • resultenumrequired
      • CONFIRMED
      • REOPENED

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

    • atstringrequired
    • seqnumberoptional

      확인한 회차 번호(10 SQL 이전 확인은 없음)

  • createdAtstringrequired
  • updatedAtstringrequired
  • effortAbleflowEffortoptional
    • EASY
    • MEDIUM
    • HARD

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

    고치는 품(기준별 고치는 방법에서 읽는다. 운영 콘솔에서 바꾸면 바로 바뀐다)

  • memostringoptional
  • object[]required

    그 프로젝트의 가장 최근 끝난 회차의 같은 묶음 위험 구간(화면 순서 · 뷰포트 순)

    • findingIdstringrequired
    • screenResultIdstringrequired
    • screenNamestringrequired
    • viewportAbleflowViewportrequired
      • PC
      • MOBILE

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

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

    • FileInfoResponseoptional

      캡처(공용 응답 주입기, "ScreenResult_{id}" · "captureImage"). 저장 못 한 캡처는 없음

    • AbleflowRegionoptional

      AbleFlow - 캡처 이미지 대비 0~1 비율

    • severityAbleflowSeverityrequired
      • HIGH
      • MEDIUM
      • LOW

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

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

  • object[]required

    상태 · 담당 · 확인 · 메모 기록(최신순). STATUS 는 상태 이름, ASSIGNEE 는 memberId(비우면 없음), MEMO 는 from · to 없음

    • typeenumrequired
      • STATUS
      • ASSIGNEE
      • VERIFICATION
      • MEMO

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

    • fromstringoptional
    • tostringoptional
    • AbleflowMemberRefoptional

      AbleFlow - 사람 표시. 이름 · 이메일은 계정 DB 에서 채운다(찾지 못하면 name 없음). 공개 API 토큰에 members:read 가 없으면 email 이 빠진다

    • atstringrequired
  • evidencestringoptional

    근거 한 줄 · 고치는 방법(기준별 고치는 방법)

  • fixstringoptional

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