AbleFlowDocs

레이블

이 프로젝트에서 쓸 수 있는 레이블 전체(공통 먼저, 이름순, 페이지 없음). screenCount 는 이 프로젝트 화면 기준

GET/api/projects/{projectId}/labels/list

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

id labels.listByProject

Path parameters

GetProjectLabelsRequestPath

  • projectIdstringrequired

Query

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

GetProjectLabelsRequestParams

  • scopeAbleflowLabelScopeoptional
    • WORKSPACE
    • PROJECT

    하나만 고를 때. 없으면 둘 다

Response 200

GetProjectLabelsResponse

  • idstringrequired
  • scopeAbleflowLabelScoperequired
    • WORKSPACE
    • PROJECT

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

    AbleFlow - 레이블 범위: 공통(워크스페이스) · 프로젝트 전용

  • projectIdstringoptional

    PROJECT 레이블만

  • namestringrequired
  • colorAbleflowLabelColorrequired
    • GRAY
    • BLUE
    • TEAL
    • GREEN
    • AMBER
    • RED
    • PINK
    • VIOLET

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

    AbleFlow - 레이블 색(다른 enum 처럼 대문자)

  • descriptionstringoptional

    설명. 없으면 빠진다

  • screenCountnumberrequired

    붙은 화면 수(삭제 · 합치기 확인 문구)

  • createdAtstringrequired
  • updatedAtstringrequired

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