Catalisa.Building Blocks

API do Feature Flags

28 endpoints em 7 recursos. A permissão de cada rota é a que o código exige — conferida linha a linha, não copiada do nome.

Ver a referência detalhada, com corpo de requisição e catálogo de erros →

29 endpoints

Flags

/feature-flags/api/v1/flags8
  • POST/feature-flags/api/v1/flagsCria flag (nasce DISABLED/off). Opcional state (on \maintenance \
  • GET/feature-flags/api/v1/flagsLista flags, paginado, filtro filter[status]FEATURE_FLAGS_READ
  • GET/feature-flags/api/v1/flags/:flagIdBusca flag por UUIDFEATURE_FLAGS_READ
  • PATCH/feature-flags/api/v1/flags/:flagIdAtualiza nome, descrição, variações e padrãoFEATURE_FLAGS_UPDATE
  • POST/feature-flags/api/v1/flags/:flagId/enableLiga a flag (estado on)FEATURE_FLAGS_TOGGLE **e** FEATURE_FLAGS_PUBLISH
  • POST/feature-flags/api/v1/flags/:flagId/disableDesliga a flag (estado off)FEATURE_FLAGS_TOGGLE
  • PUT/feature-flags/api/v1/flags/:flagId/state{ state: on \maintenance \
  • DELETE/feature-flags/api/v1/flags/:flagIdExclusão lógica. Responde 204FEATURE_FLAGS_DELETE

Segmentos

/feature-flags/api/v1/segments5
  • POST/feature-flags/api/v1/segmentsCria segmentoSEGMENTS_CREATE
  • GET/feature-flags/api/v1/segmentsLista segmentos, paginadoSEGMENTS_READ
  • GET/feature-flags/api/v1/segments/:segmentIdBusca segmento por UUIDSEGMENTS_READ
  • PATCH/feature-flags/api/v1/segments/:segmentIdAtualiza nome, descrição, ruleContent, decisionIdSEGMENTS_UPDATE
  • DELETE/feature-flags/api/v1/segments/:segmentIdExclusão lógica. Responde 204SEGMENTS_DELETE

Regras de targeting

/feature-flags/api/v1/flags6
  • POST/feature-flags/api/v1/flags/:flagId/targeting-rulesCria regraFEATURE_FLAGS_UPDATE
  • GET/feature-flags/api/v1/flags/:flagId/targeting-rulesLista regras da flag, por priority ASCFEATURE_FLAGS_READ
  • GET/feature-flags/api/v1/flags/:flagId/targeting-rules/:ruleIdBusca uma regraFEATURE_FLAGS_READ
  • PATCH/feature-flags/api/v1/flags/:flagId/targeting-rules/:ruleIdAtualiza regraFEATURE_FLAGS_UPDATE
  • DELETE/feature-flags/api/v1/flags/:flagId/targeting-rules/:ruleIdRemove regra. Responde 204FEATURE_FLAGS_UPDATE
  • POST/feature-flags/api/v1/flags/:flagId/targeting-rules/reorderReordena por lista de IDsFEATURE_FLAGS_UPDATE

Overrides

/feature-flags/api/v1/flags4
  • POST/feature-flags/api/v1/flags/:flagId/overridesFixa variação para um userIdFEATURE_FLAGS_UPDATE
  • GET/feature-flags/api/v1/flags/:flagId/overridesLista overrides, paginadoFEATURE_FLAGS_READ
  • GET/feature-flags/api/v1/flags/:flagId/overrides/:overrideIdBusca um overrideFEATURE_FLAGS_READ
  • DELETE/feature-flags/api/v1/flags/:flagId/overrides/:overrideIdRemove override. Responde 204FEATURE_FLAGS_UPDATE

Avaliação

/feature-flags/api/v1/evaluate3
  • POST/feature-flags/api/v1/evaluate/:flagKeyAvalia uma flag pela keyFEATURE_FLAGS_EVALUATE
  • POST/feature-flags/api/v1/evaluate/-batchAvalia até 50 flags de uma vezFEATURE_FLAGS_EVALUATE
  • POST/feature-flags/api/v1/evaluate/-allAvalia todas as flags ENABLED (bootstrap)FEATURE_FLAGS_EVALUATE

Capacidades

/feature-flags/api/v1/capabilities2
  • POST/feature-flags/api/v1/capabilities/:key/evaluateEstado tri-valorado de uma chave para um contextoFEATURE_FLAGS_EVALUATE
  • POST/feature-flags/api/v1/capabilities/evaluateO mesmo para keys[] (1 a 50), na ordem pedidaFEATURE_FLAGS_EVALUATE

Saúde

/feature-flags/health1
  • GET/feature-flags/healthSonda de vida. Não exige token.