VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa

Recursos e métricas

Chaves de recursos da loja (feature flags), recursos nativos que podem ser ligados ou configurados e a configuração dos cartões de métricas dos sellers.

Esta área controla o que a loja tem ligado. Há três mecanismos diferentes, e é fácil confundi-los: as chaves de recursos (feature flags) ligam ou desligam funcionalidades inteiras da vitrine e do marketplace; os recursos nativos são capacidades embutidas na plataforma que têm formulário de configuração e, em alguns casos, um interruptor; e a configuração de métricas decide como o painel de métricas dos sellers calcula e o que mostra.

Pontos principais
  • Feature flags exigem manage_settings; recursos nativos exigem manage_modules ou manage_settings; métricas exigem o módulo metrics-config ativo e privilégios de conteúdo.
  • Mudanças de feature flag e de recurso nativo valem imediatamente e ficam no registro de atividades.
  • Três feature flags foram aposentadas e dão 410 se você tentar mudá-las.
  • A gravação das métricas é completa: cartões não enviados como true somem.

Como funciona

Para decidir qual rota usar:

Quero...Use
Ligar ou desligar blog, lista de desejos, modo multi-sellerChaves de recursos
Configurar Google Analytics, SEO, reCAPTCHA...Recursos nativos (formulário em settings)
Ligar cashback, assinaturas, documentos no pedidoRecursos nativos (rota toggles)
Escolher cartões e status do painel de métricas do sellerMétricas dos sellers

Conceitos principais

Feature flag

Um interruptor booleano por loja. Lê-se o conjunto inteiro; altera-se uma chave por vez com PATCH.

Módulo e recurso nativo

Um módulo é uma funcionalidade opcional que a loja instala. Um recurso nativo vem embutido e, quando tem configuração, aparece em core-features/settings. Se um módulo exigido está desligado, as rotas dele respondem 403 com module_disabled.

Status de pedido como letra

As métricas filtram por letra de status. A letra e o significado dela são definidos por loja (veja os status em Relatórios).

Endpoints

MétodoCaminhoPara que servePágina
GET/api/v1/admin/feature-flagsEstado atual de todas as chavesChaves de recursos
PATCH/api/v1/admin/feature-flags/{key}Liga ou desliga uma chaveChaves de recursos
GET/api/v1/admin/core-features/settingsRecursos nativos configuráveis, com formulário e valores atuaisRecursos nativos
GET/api/v1/admin/core-features/togglesLista os recursos que podem ser ligados ou desligadosRecursos nativos
PUT/api/v1/admin/core-features/toggles/{moduleSlug}Liga ou desliga um recurso nativoRecursos nativos
GET/api/v1/admin/metrics-configLê a configuração de métricas (de um seller ou o padrão)Métricas dos sellers
PUT/api/v1/admin/metrics-configGrava a configuração (e opcionalmente como padrão da loja)Métricas dos sellers
POST/api/v1/admin/metrics-config/replicateCopia a configuração de um seller para todos os outrosMétricas dos sellers

Erros comuns

  • Confundir GET /admin/feature-flags (interruptores) com core-features/toggles (recursos nativos).
  • Tentar alterar soft_delete, field_masking ou cdn_support: dá 410 e nada é gravado.
  • Omitir enabled no PATCH: o padrão é false e a chave é desligada.
  • Enviar só alguns cartões em PUT /admin/metrics-config e perder os outros.
  • Chamar metrics-config em uma loja sem o módulo: responde 403 module_disabled.
  • Usar replicate para "testar": ele sobrescreve todos os sellers ativos.

Próximos passos

Chaves de recursos
Interruptores da loja.
Recursos nativos
Formulários e liga/desliga.
Métricas dos sellers
Status e cartões do painel.
Anterior
Limpar registros antigos
Próxima
Chaves de recursos
Nesta página
  • Como funciona
  • Conceitos principais
  • Feature flag
  • Módulo e recurso nativo
  • Status de pedido como letra
  • Endpoints
  • Erros comuns
  • Próximos passos