Criando um catálogo
Cada produto no Alana Shopping vive dentro de um catálogo. Crie um para começar a organizar seus produtos:
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalogs" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Primavera 2026",
"description": "Coleção sazonal para Primavera 2026"
}'
Fluxo de trabalho de publicação
O fluxo de trabalho recomendado para gerenciar conteúdo de produtos segue um padrão fork-editar-merge:
Publicar um catálogo
curl -X POST ".../catalogs/{catalogId}/publish" \
-H "Authorization: Bearer YOUR_API_KEY"
/api/catalog/products.
Bifurcar para edição
curl -X POST ".../catalogs/{catalogId}/fork" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"name": "Primavera 2026 — Revisão QA"}'
Mesclar mudanças de volta
curl -X POST ".../catalogs/{catalogId}/merge" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"targetCatalogId": "PARENT_CATALOG_ID"}'
Ações em lote
Execute estágios do pipeline em massa na visão do catálogo ou via API:
- Normalizar (Silver) — mapeamento de campos, detecção de duplicatas, validação de URLs de imagem para uma seleção ou catálogo inteiro
- Analisar (Gold) — scoring de otimização em 7 estágios da rubrica, produz pontuação + lista de gaps por produto
# Lote Silver — normalizar catálogo inteiro
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/silver" \
-H "Authorization: Bearer SUA_CHAVE_API" \
-d '{"scope": "all"}'
# Lote Gold — pontuar catálogo inteiro
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/gold" \
-H "Authorization: Bearer SUA_CHAVE_API" \
-d '{"scope": "all"}'
Configurações do pipeline
Customize como Silver e Gold processam seus produtos:
- Mapeamentos de campos Silver — mapear nomes de colunas de origem para campos do schema Alana
- Pesos de scoring Gold — ajustar pesos por estágio da rubrica (identidade, conteúdo, mídia, etc.)
- Auto-trigger — executar Silver automaticamente após Bronze, ou Gold após Silver
Veja Configurações do Pipeline para o guia completo de configuração.
Rastreamento da evolução do score
A pontuação de otimização é rastreada ao longo do tempo em score_history. Use isso para medir o impacto de melhorias de conteúdo — antes e depois de executar melhoria com IA ou normalização em lote.
Estatísticas do catálogo
Cada catálogo rastreia métricas-chave que ajudam você a avaliar qualidade do conteúdo:
- Total de produtos — quantos produtos estão no catálogo
- Contagem pronta para feed — produtos que passam em todas as regras de validação
- Pontuação média de otimização — pontuação média de qualidade em todos os produtos
- Distribuição de scores — breakdown por faixas excelente/bom/atenção/ruim
- Última publicação — quando o catálogo foi publicado pela última vez
Busque 100% de produtos prontos para feed antes de publicar. Execute o Lote Gold primeiro para identificar quais produtos precisam de mais atenção.
