AbleFlowDocs

진단

화면별 진행 단계(폴링 3초 권장, 끝나면 멈춤). 창을 닫아도 서버에서 계속된다

GET/api/diagnoses/{diagnosisId}/progress

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

id diagnoses.progress

Path parameters

GetDiagnosisProgressRequestPath

  • diagnosisIdstringrequired

Response 200

GetDiagnosisProgressResponse

  • statusAbleflowDiagnosisStatusrequired
    • QUEUED
    • RUNNING
    • COMPLETED
    • PARTIAL
    • FAILED
    • CANCELED

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

    AbleFlow - 회차 상태. 진행 중(QUEUED · RUNNING)은 프로젝트에 하나

  • analysisCountnumberrequired
  • completedCountnumberrequired
  • failedCountnumberrequired
  • estimatedRemainingSecondsnumberoptional

    진행 중일 때 남은 분석 수 × 최근 20개 분석 평균 처리 시간(모르면 빠진다)

  • object[]required

    화면 순서 · 뷰포트 순

    • screenResultIdstringrequired
    • screenIdstringrequired
    • 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 없음)

    • 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 을 건너뛴다)

    • uxRiskScorenumberoptional

      COMPLETED 만

    • objectoptional

      가장 심각한 위험 구간 한 줄(심각도 → 만든 순)

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

      FAILED 만

    • failureDetailstringoptional

      FAILED 만. 한 줄 이유(한국어 원문 — AbleFlow 웹은 접기 영역 "기술 정보"에 보인다). 서버가 만든 실패 문구면 failureCode · failureArgs 가 함께 나간다. AI 판단 비용 상한(aiBudgetExceeded) · 장부 오류(aiCallFailed)는 사용량 장부의 원인 글 그대로다(예: "이번 달 'AbleFlow 화면 판단' 기능의 AI 사용 한도(… USD)를 모두 사용했습니다. …")

    • failureCodestringoptional

      실패 문구 키(예: pageNotFound, 키 목록은 AbleflowFailureMessageArgs 설명). 키를 쓰기 전 옛 행은 빠진다 — 그때는 failureDetail 을 그대로 보인다

    • AbleflowFailureMessageArgsoptional

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

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