진단 결과
회차별 위험도 추세(실제 끝난 COMPLETED · PARTIAL 회차만, 예측 없음). 오래된 순.
GET/api/projects/{projectId}/diagnoses/trend
전체(uxRiskScore)와 기준별(criteria[].score) 점수를 한 점에 함께 둬 화면이 "전체 · 기준별" 보기 모드를 바꿔 그린다(새 요청 없이)
- Scope
results:read - Since
1.0.0 - Success
200 - Demo tokenAllowed
id diagnoses.trend
Path parameters
GetDiagnosisTrendRequestPath
projectIdstringrequired
Query
쿼리의 배열은 콤마로 이어 보낸다(status=A,B)
GetDiagnosisTrendRequestParams
fromstringoptional만든 시각 범위(ISO-8601, from 포함 · to 미포함 — 진단 기록 목록과 같은 기준). 둘 다 없으면 최근 12회차, 있으면 최대 10000
tostringoptionaltriggerAbleflowDiagnosisTrigger[]optional콤마 구분, 없으면 전부
Response 200
GetDiagnosisTrendResponse
alertDeltanumberoptional알림 기준선(반복 진단 스케줄 alertDelta). 스케줄 기능 전이라 지금은 늘 빠진다
- object[]required
diagnosisIdstringrequiredseqnumberrequiredtriggerAbleflowDiagnosisTriggerrequiredMANUALFREE_TRIALSCHEDULEDPRE_DEPLOY
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
AbleFlow - 회차를 만든 계기. 사용자 실행은 MANUAL
statusenumrequiredCOMPLETEDPARTIAL
Newer versions may send values you don't know. Handle unknown values safely (for example as 'other').
finishedAtstringrequireduxRiskScorenumberrequired전체(대표 위험도, 0~100 높을수록 위험)
- object[]required
기준별(기준 순서). 그 회차가 고르지 않았거나 평가하지 못한 기준은 빠진다(선을 끊어 그린다)
scoringVersionstringrequired지난 점과 다르면 화면에 안내
alertedbooleanrequired이 회차에서 알림이 갔는지(반복 진단 알림 기능 전이라 지금은 늘 false)
Errors
| Status | Code | When |
|---|---|---|
| 400 | BAD_REQUEST | 잘못된 시각 · 계기 |
9 errors common to every public API
| Status | Code | When |
|---|---|---|
| 400 | UNSUPPORTED_API_VERSION | AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported } |
| 401 | UNAUTHORIZED | Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다 |
| 401 | INVALID_TOKEN | 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함) |
| 401 | TOKEN_EXPIRED | 토큰이 만료됐다 |
| 403 | INSUFFICIENT_SCOPE | 토큰 범위가 모자란다. detail { required } |
| 403 | DEMO_READ_ONLY | 데모 토큰은 GET · HEAD 만 부를 수 있다 |
| 403 | PLAN_FEATURE_REQUIRED | 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? } |
| 404 | RESOURCE_NOT_FOUND | 자원이 없거나 토큰이 묶인 워크스페이스 밖이다 |
| 429 | API_RATE_LIMITED | 호출 한도를 넘었다. Retry-After(초) |