개선 과제
과제 상태 탭 숫자. 페이지 조회와 같은 필터에서 페이지 · status 만 뺀다
GET/api/workspaces/{workspaceId}/issues/counts
- Scope
issues:read - Since
1.0.0 - Success
200 - Demo tokenAllowed
id issues.counts
Path parameters
GetIssueCountsRequestPath
workspaceIdstringrequired
Query
쿼리의 배열은 콤마로 이어 보낸다(status=A,B)
GetIssueCountsRequestParams
keywordstringoptional제목 검색어(대소문자 무시). 한국어 원문 제목과 요청 언어(?locale= en · ja · zh-CN · zh-Hant)의 AI 제목 번역에서 찾는다(OR)
titleKeysstring[]optional제목 문구 키(콤마 구분, 예: textContrastLow — 키 목록은 AbleflowFindingMessageArgs 설명). keyword 와 함께 오면 제목에 keyword 가 들어 있거나 제목 문구 키가 이 중 하나인 과제(OR). 규칙 제목 원문은 한국어라 다른 언어 화면의 검색어는 원문에 없다 — 화면 언어 메시지에서 검색어가 들어간 키를 찾아 같이 보낸다 (AI 제목은 서버가 요청 언어 번역에서 찾는다). 모르는 키는 무시한다(형식이 틀리면 400)
projectIdsstring[]optional콤마 구분
criterionAbleflowCriterion[]optionalAbleFlow - 진단 기준
severityAbleflowSeverity[]optionalAbleFlow - 위험 구간 심각도(화면 표기 높음 · 보통 · 낮음)
assigneestring[]optional담당 memberId(콤마 구분) · "me" 는 나 · "none" 은 담당 없음. 그 밖의 값은 400
Response 200
GetIssueCountsResponse
totalnumberrequired- objectrequired
모든 상태를 0 까지 채운다
TODOnumberrequiredIN_PROGRESSnumberrequiredIN_REVIEWnumberrequiredDONEnumberrequiredON_HOLDnumberrequiredDISMISSEDnumberrequired
Errors
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(초) |